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PREFACE 


MANUAL OBJECTIVES 


This manual describes the VAX-11l Image File Patch Utility (PATCH). It 
contains general usage information about PATCH, the syntax rules for 
using PATCH correctly, and reference information about PATCH commands. 


INTENDED AUDIENCE 


This manual is intended to be used by experienced system programmers 
who are writing or modifying device driver images, shareable images, 
or executable images. Familiarity with a patching utility is not 
required; this manual provides introductory information on PATCH and 
on PATCH-specific concepts and terminology. 


STRUCTURE OF THIS DOCUMENT 
This manual contains eight chapters and two appendixes: 


e Chapter 1 contains a functional overview of the PATCH utility. 
It introduces basic concepts in PATCH and illustrates a simple 
PATCH session. The remainder of the chapter summarizes’ the 
PATCH commands by functional category. 


e Chapter 2 discusses PATCH input and output files. 


e Chapter 3 explains how to run PATCH and how PATCH’ command 
qualifiers affect the output files. 


e Chapter 4 provides an overview of symbol usage in PATCH -- the 
various symbols recognized by PATCH, how to use symbols to 
reference locations, and how PATCH performs symbol and value 
translations. 


e Chapter 5 describes the two types of patch area available in 
PATCH, including when’ to choose one type of patch area over 
the other, how to access patch area, and the commands” that 
affect patch area. 


e Chapter 6 provides a complete introduction, with examples, to 
PATCH's entry and display modes. In addition, this chapter 
contains a functional summary of the modes. 


e Chapter 7 describes the syntax rules PATCH follows when 
processing commands. 


e Chapter 8 contains detailed descriptions of all PATCH 
commands; the commands are listed in alphabetical order. 


vii 


e Appendix A contains an alphabetical listing of the PATCH 
commands in their required format. Also included are the 
qualifiers that can be specified with the commands and a brief 
functional definition of each command. 

e Appendix B lists the error messages produced by PATCH. Each 
error message is accompanied by a brief definition of the 


error and, in some cases, a Suggested uSer response is 
supplied. 


ASSOCIATED DOCUMENTS 


Other manuals that may be of uSe are: 


e VAX-11 Symbolic Debugger Reference Manual 


e VAX-11 Linker Reference Manual 


CONVENTIONS USED IN THIS DOCUMENT 


The following conventions are used in this manual: 


PATCH> EXAMINE/INSTRUCTION 606 In all examples, the output 

00000606: ‘'TSTL R4' lines and prompting characters 
printed or displayed by the 
system are in black ink; all 
user-entered commands’ are in 
red ink. 

CTRL/x The expression "CTRL/x" means 


that you enter a_control 
character by pressing the 
appropriate key while you hold 
down the CTRL key. 


new-instruction A vertical ellipsis indicates 
: that not all the data _ the 
F system would normally display 
° or a user would normally enter 


is shown. 


eco-level,... A horizontal ellipsis 
indicates that additional 
parameters, values, or 


information can be entered. 


[symbol-name] Square brackets indicate that 
the enclosed expression is 
optional. 
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CHAPTER 1 


OVERVIEW 


After you have compiled or assembled and linked a program, you may 
find it necessary to make one or more changes to the code. There are 
two ways to change the code. One way is to edit the source program, 
recompile or re-assemble, relink, and run the new version. Sometimes, 
however, the source program is not readily available for editing or 
the time required to make the changes and create an executable image 
is far too lengthy. A second way, then, is to use the VAX-1l Image 
File Patch Utility (PATCH). 


PATCH provides an extensive set of commands that lets you make changes 
directly to the image file and then run the new version without 
recompiling or re-assembling and relinking. Furthermore, PATCH 
creates a journal file in which all PATCH commands used are recorded. 
This file provides an easy way to keep track of the changes’ and 
attempted changes made to an image file. 


You can use PATCH to edit an image file during an interactive terminal 
session. You can also enter PATCH commands in a command procedure 
then submit the command procedure for interactive or batch mode 
processing. 


PATCH also provides several features to help you find and correct 
erroneous code. These features include: 


e Symbolic referencing of locations 
e Patch area to store additional data and instructions 


e Entry and display modes to control the environment in which 
PATCH accepts your commands and displays its output 


This chapter provides a brief overview of the PATCH utility and 
directs you to the appropriate chapters that contain more detailed 
descriptions of the particulars of PATCH. The colored pages at the 
end of this chapter list the PATCH commands by function. 


1.1 WHEN TO USE PATCH 


PATCH is intended to be used to maintain executable image files, 
shareable image files, and device-driver image files written by users 
in any language supported by the VAX/VMS operating system. PATCH is 
not intended for. customer use on DIGITAL software. Any revisions 
applied to this software, except those contained in DIGITAL-supplied 
auto update kits, may make it difficult for you to install future 
software updates. Furthermore, application of patches to VAX/VMS 
software which are not supplied by DIGITAL, invalidates the warranty 
on the DIGITAL-supplied VAX/VMS software. 
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1.2 PATCH AND THE VAX-11 SYMBOLIC DEBUGGER 


In many cases, PATCH can be used with the VAX-11 Symbolic Debugger. 
The debugger lets you step through your image file and make temporary 
changes to the code. Once you have decided on the new code, PATCH 
Makes the changes permanent in the new version of the image file. 
Keep in mind, however, that the source code will not contain your 
changes until you enter’ them. For a detailed description of the 
function and capabilities of the VAX-11 Symbolic Debugger, see _ the 


VAX-11 Symbolic Debugger Reference Manual. 


1.3 INPUT AND OUTPUT FILES 


You can use PATCH to make changes to an image file during an 
interactive terminal session or by submitting a command procedure for 
interactive or batch mode processing. 


During interactive patching, input consists of an input image file, 
which is the file you want updated, and PATCH commands that, when 
executed, perform the requested changes. 


During patching by means of a command procedure, the only input is a 
PATCH command procedure, which can be created during a PATCH session 
or by uSing a text editor. -The command procedure contains the name of 
the image file to be patched and the PATCH commands you want applied 
to the image file. 


When you patch an image file, PATCH can produce the following three 
output files: 





File Description 
Output image file An updated image file. This file must be 
explicitly created using the UPDATE 
command. 
Journal file An ASCII file containing a record of the 


PATCH session. This file is automatically 
created by PATCH. 


Command procedure A file containing all successful PATCH 
commands that can subsequently be used as 
input to PATCH. This file must be 
explicitly created using the CREATE 
command. 


Refer to Figure 1-1 to see how PATCH updates an image file and _ read 
Chapter 2 for a complete description of PATCH's input and output 
files. 


1.4 USING PATCH 


This section contains general information necessary for using PATCH 
efficiently and effectively. This information includes how to run 
PATCH and how to apply a patch to an image file; it also includes 
information on symbol usage, patch area, and the entry and display 
modes. 
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Figure 1-1 PATCH Input and Output 


1.4.1 Starting and Stopping PATCH 


The following DCL command line invokes PATCH for an _ interactive 
terminal session: 


$ PATCH file-spec <RET> 


The file-spec indicates the name of the input image file that is to be 
patched. 


After you press the RETURN key, PATCH displays an introductory 
message, then indicates that it is ready to accept commands by issuing 
the following prompt: 


PATCH> 


Once you have initiated PATCH, you can interrupt program execution by 
typing CTRL/Y (echoed as “Y). Typing this command returns control to 
the VAX/VMS command interpreter. If you decide that you still want to 
execute PATCH, type the CONTINUE command. 


To end a PATCH session, type either the EXIT command or CTRL/Z. 
Chapter 3 provides a complete description, with examples, on starting 


and stopping PATCH, including how to submit command procedures for 
interactive and batch mode processing. 
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1.4.2 Applying Patches 


Whenever you apply a patch to an image file, whether the patch is to 
be applied interactively or through a command procedure, the following 
types of PATCH commands should be used: 


e A patch initiator -- the SET ECO command that defines a unique 
Engineering Change Order (ECO) level between 1 and 128, 
inclusive for each patch. The ECO level serveS as an 
identifier for the patch. (See Chapter 8.) 


e PATCH commands that examine and modify the image file. (See 
Chapter 8.) 


e A patch terminator -- the UPDATE command that sets the ECO 


level and applies the patch to the image file. (See Chapter 
8.) 


These commands must be used in the order shown. They can be repeated 
as many times as necessary during one execution of PATCH. 


The following example typifies a patch for the image file named 
NEGATION.EXE;1: 


PATCH® SET ECO 1 

PATCH> EXAMINE/INSTRUCTION 606 

000006063 TSTL R4 

PATCH> REPLACE/INSTRUCTION 606 = ‘TSTL R4’ 

NEW> ‘TSTL RS’ 

NEW> EXIT 

olds 000006063 TSTL R4 

new: 00000606; TSTL RS 

PATCH> UPDATE 

“PATCH-I-WRTIFIL» uedating imade file DRI CGARTHINEGATION.-EXE$2 


In the above example, the ECO level is defined as 1. The EXAMINE 
command requests that location 606 be displayed as a VAX-11 MACRO 
instruction. The REPLACE command then changes the instruction in 
location 606 to a different instruction. The UPDATE command sets ECO 
level 1 and applies the patch to NEGATION.EXE. 


For information on individual PATCH commands, see Chapter 8. 


1.4.3 Using Symbols 


To change the code in an image file, you need to identify the 
locations that contain the erroneous instructions or data. That is, 
you must identify the virtual addresses within the image file. You 
can locate virtual addresses using one of two ways: 


1. Obtain a listing and a map of the image file; the listing 
gives you the relative offsets for each module in your image 
file, and the map tells you where each module starts in 
virtual memory. 


2. Locate the addresses by means of symbolic names defined in 
the image file when it was created. 


Using the second method, upon invoking PATCH, you can reference 
locations by specifying the symbolic names assigned to them and PATCH 
will resolve the symbolic references using the symbol table and scope. 


OVERVIEW 


1.4.3.1  PATCH's Symbol Table - PATCH provides a symbol table in which 
all symbols are placed. (See Chapter 4 for information on passing 
symbols to PATCH.) Any symbol contained in this table can be used _ to 
access one or more locations. PATCH will display an error message 
when you attempt to use a symbol not contained in this table. 


To determine the status of the symbols in the symbol table, type the 
SHOW MODULE command. Then if you want to add or delete specific 
symbol information, type the SET MODULE or CANCEL MODULE command. 
These commands are fully described in Chapter 8. 


1.4.3.2 Definition of Scope - When a symbol is multiply defined (that 
is, when it represents two or more memory locations) and the symbol is 
available to PATCH, you must indicate which memory location you mean 
to reference when you use that symbol in a command. You do so by 
specifying the "scope" of the symbol. The scope is the name of the 
module and optionally routine in which the symbol appears. To 
establish the correct scope, type the SET SCOPE command or prefix the 
symbol with the module or routine name in which it is contained. For 
more information on the SET SCOPE command, see Chapter 8. 


1.4.3.3 Symbols and Pathnames - PATCH allows you to use symbols and 
pathnames to find and to define specific memory locations within your 
image file. The symbols PATCH recognizes are: 

e Global symbols 

e Local symbols 

e Module names, program section names, and routine names 

e Universal symbols 

e Symbolic instruction labels 

e Symbols defined with the DEFINE command 
Some symbols, such as two local symbols or a local and global symbol, 
may represent more than one memory location in an image file. For 
example, the local symbol XYZ could represent a memory location in 
module A and another memory location in module B. To resolve the 
ambiguity of symbol XYZ, PATCH allows the use of pathnames- to 
reference locations. 
A pathname is a complete and unambiguous symbolic translation of a 
location. That is, a pathname defines the scope, symbol name, and 
offset value, in the following format: 

scope\symbol-name+offset-—value 


If the symbol is unique, the pathname consists of the symbol name and, 
possibly, an offset value; the scope becomes unnecessary. 


For a detailed description of the various symbols’ that PATCH 
recognizes, see Chapter 4. 
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1.4.3.4 Passing Symbols - To ensure that symbols are available for 
your use, you must include certain information at assembly or compile 
and link time. For example, to pass local symbols in a MACRO program, 
include the /ENABLE=DEBUG qualifier when you assemble the program and 
the /DEBUG qualifier when you link the program. 


Read the appropriate language user's guide to determine which 
qualifiers are required to pass symbol information to PATCH and read 
the VAX-11 Linker Reference Manual to determine how to pass’ universal 
symbols to PATCH. 


1.4.4 Using Patch Area 


In many cases, applying a patch to an image file requires adding lines 
of code to the file. A convenient technique for adding code is to 
insert such code into storage space called patch area. 


There are two types of patch areas: default patch area and 
user-defined patch area. 


PATCH automatically inserts additional code into the current’ patch 
area (either default or user defined) when there is not enough space 
at the requested location to insert the code. PATCH then inserts 
branch instructions to and from the patch area to maintain the correct 
flow of program execution. 


You can also request that data be placed in the current patch area by 
issuing the DEPOSIT/PATCH_AREA command. Keep in mind, however, that 
PATCH does not generate branch instructions to and from the patch area 
when you use the DEPOSIT/PATCH_AREA command; you must keep track of 
and document the correct flow of program execution. 


For complete information on when and how to use default patch area and 
user-defined patch area, see Chapter 5. 


1.4.5 Using Entry and Display Modes 


To make referencing locations in an image file more convenient, PATCH 
provides four major categories of addressing modes, also called entry 
and display modes. These four mode categories are: context, radix, 
length, and symbol search. Table 1-1 provides a brief functional 
definition of each mode category. 


When you invoke PATCH, the modes are set to: NOASCII, NOINSTRUCTION, 
SYMBOLS, HEXADECIMAL, LONG, NOGLOBALS, and SCOPE. To change these 
modes, issue the SET MODE and CANCEL MODE commands or issue an 
alternative mode qualifier on the command line. 


Entry and display modes are discussed in Chapter 6, and in Chapter 8 
under the SET MODE command. 
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Table 1-1 
Functional Division of the Entry and Display Modes 


Context [NO] ASCII Controls whether PATCH accepts”) and 
[NO] INSTRUCTION displays data as ASCII text or VAX-1l 
[NO] SYMBOLS MACRO instructions, and displays 

addresses in symbolic representation 


OCTAL Controls the base in which PATCH 


DECIMAL accepts and displays data and 
HEXADECIMAL addresses 


Length BYTE Controls the size in which PATCH 
WORD accepts and displays data 
LONG 


Symbol [NO] GLOBALS Controls how PATCH evaluates symbol 
Search [NO] SCOPE and value translations 





1.5 SAMPLE PATCH SESSION 


This section uses an example to illustrate an interactive PATCH 
session. The following VAX-11 MACRO program prompts for a decimal 
integer, then displays the negation of the integer. 


0000 1 +TITLE NEGATION ~ Calculates nesdation of decimal integer 
0000 2 +IQENT /01/7 
0000 3 
0000 4 SUBTITLE ~ Pure Data 
00000000 § +PSECT RO. DATA» NOWRT »NOEXE 2 LONG 
0000 6 
0000 7 PROMPT? .ASCII /Enter decimal inteser/ 
000C 
0016 8 
0016 9 PROMPT..LEN = .-PROMPT 
0016 10 RESULT_FAO3 
0016 11 *-ASCID \The negation is !Sh.N 
0024 
0030 
0032 12 
0032 13 «SUBTITLE ~ Imreure Data 
00000000 14 *+PSECT RW DATAr NOEXE » LONG 
0000 15 
0000 16 BUFFER.SIZE ES 132 sBuffer size 
0000 17 BUFFER DESC? 
0000 19 +LONG BUFFER.SIZE» BUFFER sDescrietor for buffer 
0008 19 
0008 20 BUFFER? 
0008 al +BLKB BUFFER.SIZE Buffer to det line 
008Cc 22 
008Cc 23 INTEGER? 
008C 24 »BLKL 1 SIneut integer 
0090 25 RESULT3 
0090 26 + BLEL 1 sResult of oreration 
0094 27 
0094 28 +SUBTITLE Define RAB and FAB for terminal 1/0 
0094 ago 


0094 30 TRMFAB? $FAB FNM=<SYSSINPUT>»RAT=CR $§FAB for terminal 
OOE4 31 TRMRAB? $RAB FAB=TRMF AB, UBF =BUFFER » USZ=BUFFER.SIZE »ROP=PMT~ 


OOE4 32 PRF=PROMPT » PSZ=PROMPT..LEN SRAB for terminal 
0128 33 
0128 34 +SUBTITLE PROGRAM ENTRY POINT 
00000000 35 +PSECT RO..CODE »EXE »NOWRT 
9000 36 sENTRY ENTRY.POINT sO 


1-7 


0002 
0002 
OOOF 
001iCc 
0029 
0029 
002F 
0035 
0035 
003C 
0043 
O04E 
O04E 
004E 
OO4E 
004E 
O04E 
004E 


006D 
006D 
006D 
006D 
0078 
0085 
0089 
008A 
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37 

38 $OPEN FAB=TRMFAB sOren terminal file 

39 SCONNECT RAB=TRMRAB §Connect record stream 

40 $GET RAB=TRMRAB Get ineut from terminal 
41 

42 PUSHAL INTEGER sPush integer address on stack 
43 PUSHL RABSLHRBF+TRMRAB sPush starting address of 
44 Sineut on stack 

45 MOVZWL RABSW.RSZ+TRMRABr-(SF) Push lendth of input on stack 
46 CALLS #3,G°LIBSCVUT_DTB ‘Convert to binary 

47 MOVL INTEGER» RESULT iCalculate negation 

48 

49 jDetermine length and contents of result 

50 

$1 $FA0_S CTRSTR=RESULT_FA0?— 

32 OUTLEN~TRMRABtRABSW._RSZ > —- 

53 OUTBUF=BUFFER.DESC »- 

54 P1i=RESULT 

53 

56 sOutrut result 

57 

58 MOVAB BUFFER» TRMRAB+RABSL _RBF 

59 $PUT RAB=TRMRARB 

40 MOVZBL #SS% NORMAL »RO 

41 RET 

62 eEND ENTRY POINT 


The program will assemble and link, but when executed will produce 
erroneous results, as follows: 


$ MACRO/ENABLE=DEBUG NEGATION.MAC31 
$ LINK/BDEBUG NEGATION.OBJ31 

$ RUN/NODEBUG NEGATION.EXE$1 

Enter decimal intesder 25 

The negation is 25, 


$ 


After locating the incorrect code, by use of the VAX-11 Symbolic 


Debugger 


or simply by examining the listing, you can invoke PATCH to 


make a permanent change in the image file as shown below. The numbers 
to the right of the example are keyed to the explanations that follow 
the example. 


$ PATCH NEGATION.EXE$1 


PATCH VERSION 2.0 15 MAR 80 


PATCH> SET ECO i 2 ] 

PATCH> SET MODULE/ALL 

PATCH> SET SCOPE NEGATION 

PATCH> SET MODE INSTRUCTION 

PATCH> EXAMINE RO_CODE+43 

NEGATION\RO_CODE +43 MOVL L“NEGATIONNINTEGER » L“NEGATION\RESULT 6) 
PATCH> REPLACE NEGATION\RO_CONE+43 


OLD> 
OLD> 
NEW> 
NEW> 
old? 
news 


“MOVL L“NEGATIONNINTEGER L“NEGATION\RESULT ’ 

EXIT 

‘MNEGL L“NEGATION\INTEGER L“NEGATION\RESULT ’ 

EXIT 

NEGATION\RO_CODE+432 MOVL L”NEGATIONNINTEGERsL“NEGATION\NRESULT 
NEGATION\RO_CODE+43$ MNEGL L“NEGATIONNINTEGER»L“NEGATION\RESULT 


PATCH> UPDATE 
“4PATCH-I-WRTFIL» urdating image file DB1:CGARTHINEGATION.EXEs2 @ 
PATCH> EXIT 


$ 


Now 


1.6 


OVERVIEW 


Invoke PATCH -- Invoke PATCH for an interactive terminal session 
by typing the DCL command line PATCH NEGATION.EXE;1. PATCH, in 
return, displays an introductory message on your terminal. This 
message indicates the version of PATCH that you are using and its 
release date. 


Define an ECO level -- The SET ECO command defines the ECO level 
for the ensuing PATCH. Note that the ECO level is not set until 
you issue the UPDATE command. 


Alter the symbol status -- The SET MODULE/ALL command inserts all 
local symbol information into the symbol table provided that you 
followed the rules for passing local symbols at compile or 
assembly and link time. 


Alter the scope status -- The SET SCOPE command changes’ the 
contents of the scope. In this case, the scope has been set to 
the module named NEGATION. 


Alter entry and display mode status -- The SET MODE command sets 
the INSTRUCTION mode, causing PATCH to display the contents of 
the specified locations as VAX-11 MACRO instructions. 


Change the code -- A number of PATCH commands can be used _ to 
modify code. Each command alters the code in a unique fashion. 
In this example, the REPLACE command was used to overwrite the 
existing instruction with a new, correct instruction. 


Set the ECO level and update the image file -- After you correct 
the code, issue the UPDATE command to set the specified ECO level 
and to create a new image file consisting of the original image 
file and the patch. 


Exit from PATCH -- Type the EXIT command to end the PATCH session 
and return control to the VAX/VMS command interpreter. 


run the program NEGATION.EXE;2 and it will execute properly. 


$ RUN NEGATION.EXE#2 


Enter decimal inteser 37 
The nestation is ~37. 


$ 


COMMANDS IN PATCH 


This section describes the general format of the PATCH commands. Tt 
also provides a functionally arranged summary of these commands. 


OVERVIEW 
( 


f 


1.6.1 Command Line Format 


You issue PATCH commands to examine, verify, and modify locations in 
an image file. A PATCH command takes the following general format: 


command [/qualifier(s) ] [parameter (s) ] {[!comment] 
command 

Specifies the name of a PATCH command. 
/qualifier (s) 


Specifies the name of one or more qualifiers that modify the 
intent of the command. A qualifier can be one of the following: 


e Alignment qualifier 

e Mode qualifier 

e Other qualifier 

Mode qualifiers are briefly described under the "Mode Qualifiers" 
heading of each command in Chapter 8. For a complete description 


of the mode qualifiers, see Chapter 6. 


You can enter multiple qualifiers after a single command provided 
that you precede each qualifier with the slash character (/). 


parameter (s) 


Specifies the target of the command, such as a range of memory 
locations. 


!comment 


Specifies a comment. PATCH ignores all data starting with an 
exclamation character (!). 


See Chapter 7 for a complete description of the rules for entering 
commands. 


1.6.2 Functional Summary of PATCH Commands 


This section summarizes the uses of the PATCH commands. The commands 
are functionally grouped in the following five tables: 


e Commands for Creating Patches (Table 1-2) 

® Commands for Manipulating Patch Area (Table 1-3) 

e Commands for Examining and Modifying Locations (Table 1-4) 
e Commands for Controlling PATCH Modes (Table 1-5) 

@e Commands for Expressing Symbols and Pathnames (Table 1-6) 


These tables briefly describe each command. See Chapter 8 for 
detailed command descriptions. 
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Table 1-2 
Commands for Creating Patches 

















Command 





Description 


ethene stn at 





CHECK ECO Verifies the application of the patches 


associated with the specified ECO levels 
CHECK NOT ECO Verifies that the specified ECO levels are 
available for use 








CREATE Opens a command procedure to which all 
subsequent, successful PATCH commands are 


written 





SET ECO Defines an ECO level for the ensuing patch 





UPDATE Sets the ECO level and applies the patch to 


the image file 


acer 
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Table 1-3 
Commands for Manipulating Patch Area 


em ne NNN ee, A er pen See nett nese seen hdLASTN 


Command Description 
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Aligns the first free byte of the current 
patch area on the specified boundary and 
defines a symbol for that address 


CANCEL PATCH AREA | Cancels the use of the current user-defined 
patch area and reverts to the use of the 
default patch area 


DEPOSIT/PATCH_AREA Deposits data or VAX-11 MACRO instructions 
in the current patch area 


INSERT/INSTRUCTION Inserts one or more VAX-11 MACRO 
instructions into the current patch area 


SET PATCH _AREA Establishes a user-defined patch area 
the current patch area 


as 


SHOW PATCH_AREA Displays the string descriptor of 
current patch area 











OVERVIEW 


Table 1-4 
Commands for Examining and Modifying Locations 





Sather tsar enctica ree tn} open acinar 2A Whine steertenemnrrmratnnntat sn ein amenle te ate aN Sa eer ApS eo Soot SAMA Ona ne ARAL nd LN OAUTH PNPM HE ensarohmnamamemsernlpeteiai 4 Met i 





Command Description 

DELETE Verifies the current contents of one or 
more consecutive locations, then replaces 
the contents with NOP instructions or zeros 

DEPOSIT Deposits new values into one or more 
consecutive locations 

EXAMINE Displays the contents of one or more 
locations 

INSERT/INSTRUCTION Verifies the current contents of a 
location, then inserts one or more VAX-11l 
MACRO instructions after that location 

REPLACE Verifies the contents of one or more 
consecutive locations, then replaces the 
contents with new contents 

VERIFY Verifies the contents of one or more 


consecutive locations 





Table 1-5 
Commands for Controlling PATCH Modes 
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Command Description 


CANCEL MODE Cancels the current mode _ settings and 


reinstates the initial mode settings 


SET MODE Sets new entry and display modes 


SHOW MODE 


Displays the current mode settings 
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Table 1-6 
Commands for Expressing Symbols and Pathnames 
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Command 





Description 
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CANCEL MODULE Removes local symbols and program section 
names defined in the specified module from 
PATCH's symbol table 

CANCEL SCOPE Cancels the current symbolic scope _ and 
reinstates the <null> scope 


DEFINE Equates a symbolic name with a value 


EVALUATE Displays the current symbolic definition or 
definitions of a value 

SET MODULE Enters local symbols and program section 
names defined in the specified module into 
PATCH's symbol table 


SET SCOPE Defines the current symbolic scope 


SHOW MODULE Displays all the modules in the image file’ 
being patched and indicates whether the 
local symbols contained in those modules 
are entered in PATCH's symbol table 


SHOW SCOPE 


stem anemones emma ns anemeenecnentaenret mine eee 


Displays the current symbolic scope 
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CHAPTER 2 


PATCH INPUT AND OUTPUT FILES 


Input to PATCH is (1) an input image file that you want to update and 
(2) PATCH commands that perform the requested update operations. You 
can issue PATCH commands directly from your terminal or you can enter 
the commands in a command procedure in the order of their execution 
then submit the command procedure for interactive or batch mode 
processing. 


PATCH creates one or more of the following files as output: 
e Output image file 
e Journal file 
@e Command procedure 


The output image file and command procedure are optional files. You 
must request them for PATCH to create them. PATCH automatically 
creates a journal file. 


This chapter describes PATCH input and output files. See Chapter 8 
for PATCH command descriptions. 


2.1 INPUT IMAGE FILE 


The input image file is the file you want to update. Because PATCH is 
not a language-dependent utility, you can use it to update an image 
file written in any language supported by the VAX/VMS' operating 
system. The input image file can be a shareable image, device driver 
image, or executable image. The only restriction is that the input 
image file must be created by the VAX-11 Linker. 


PATCH never alters the input image file. When you invoke PATCH, it 
creates a copy of the input image file and then incorporates your 
changes into the copy. You can thus test the new image file and, if 
it does not run correctly, still have the original file to 
re-evaluate. 


2.1.1 Shareable Images 


A shareable image is an image that does not have a starting address 
and must be linked with one or more object modules to produce an 
executable image. 
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You must take the following into consideration when patching shareable 
images: 


e You can specify only universal symbols when patching a 
Shareable image (see Section 4.1.4) 


e You should use a user-defined patch area rather than the 
default patch area to store additional instructions and data 
(see Section 5.2.1 ) 


For additional information on shareable images, see the VAX-11l:. Linker 
Reference Manual. ‘ 


2.1.2 Device Driver Images 


A device driver image is a set of routines and tables used by the 
operating system to process an I/O request for a particular device 
type. To patch a device driver image, you should use a_ user-defined 
patch area rather than the default patch area to store additional 
instructions and data. (See Section 5.2.1.) 


2.1.3 Executable Images 


An executable image is the most common type of image. An executable 
image iS one that can be run by a process. When run, an executable 
image is read from a file for execution by a _ process. Patching an 
executable image requires no special rules or considerations. Simply 
use PATCH as described in this manual. For additional information on 
executable images, see the VAX-1l Linker Reference Manual. 


2.2 OUTPUT IMAGE FILE 


The output image file is an updated input image file. It consists of 
1) all the changes performed by the commands, and 2) the original data 
that was not altered. An output image file is always created after 
you enter the UPDATE command. If you fail to enter the UPDATE 
command, PATCH does not create an output image file. 


During a Single execution of PATCH, you can apply several patches’ to 
an image file. AS you terminate each patch (by issuing the UPDATE 
command), PATCH updates the output image file. The first UPDATE 
command creates the output image file; subsequent UPDATE commands 
(issued during the current PATCH session) overwrite this file. 


By default, the output image file specification consists of the same 
file name and type as the input image file name and type, and a 
version number 1 greater than the highest version of the input image 
file. Also by default, the file is created in your process's current 
device and directory. 


To change the default file specification for the output image file, 
use the /OUTPUT command qualifier with the PATCH command. This 
qualifier is described in Section 3.2. 
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2.3 JOURNAL FILE 


The journal file provides a complete record of all PATCH commands 
issued during the editing of an input image file. A journal file 
entry is created every time a PATCH command is processed. The journal 
file, then, provides a record not only of changes actually made, but 
also unsuccessful attempts to edit the input image file. 


A journal file is maintained for every PATCH session. If a journal 
file already exists for a particular file, the new journal entries are 
appended to it. Otherwise, PATCH creates a journal file with the same 
file name as the input image file name, a file type of JNL and a 
version number of 1. Also by default, the file is created in your 
process's current default device and directory. 


To change the default file specification for the journal file, use the 
/JOURNAL command qualifier with the PATCH command. This qualifier is 
described in Section 3.2. 


Entries in a journal file are written as ASCII text, thereby allowing 
you to examine the contents of the journal file simply by issuing the 
DCL command PRINT or TYPE. 


Figure 2-1 illustrates a typical journal file that contains two PATCH 
sessions. 


2.4 COMMAND PROCEDURE 


You can use a command procedure to apply patches to an image file. A 
command procedure is a sequence of commands and, optionally, input 
data that performs a specific action, similar to a program (see _ the 


VAX/VMS Guide to Using Command Procedures). 


Used with PATCH, a command procedure is a file of PATCH commands that, 
when the command procedure is executed, will apply patches to a 
particular image file. Usually, you create a command procedure to 
facilitate the task of patching multiple copies of a particular image 
file. Instead of manually patching each file, you can submit a 
command procedure for interactive or batch mode processing. 


See Chapter 3 for complete information on submitting command 
procedures for interactive and batch mode processing. 


There are two ways to create command procedures. One way is to use 
the PATCH command CREATE. The second way is to use an interactive 
text editor. Both ways are described below. 


2.4.1 Using the CREATE Command to Create Command Procedures 


After you invoke PATCH, issue the CREATE command to request that a 
command procedure be created and opened. PATCH automatically inserts 
the name of the input image file as the first entry in the command 
procedure. All subsequent, successful PATCH commands are then written 
into this file. See Chapter 8 for a complete description of the 
CREATE command. 
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PATCH VERSION 2.0 15 MAR 80 


IMAGE FILE BEING FATCHED: "DBI? CEAGLE JAVERAGE.EXE#2"* 
JOURNAL FILE: "DB1} CEAGLEJAVERAGE.JNL#1° 
DATE/TIME OF PATCH 20~MAR-1980 122335205.53 


PATCH>CREATE AVERCMD 

COMMAND FILE? "DB1? CEAGLE JAVERCMI.COMs1° 
PATCH)SET ECO 1 

FATCH>SET MODE NOSYMBOLS» INSTRUCTION 

PATCH>SHOW MODE 


modes: nosymbols: instructions noasciiy score» nosglobalss hexadecimals longs 
PATCH>EXAMINE 627 


000006273 PUSHAL L“00000224 
PATCH>INSERT/INSTRUCTION 
LOC>627 


OLD>’PUSHAL L™00000224’ 
NEW>’DECL (RO) 


NEWSEXIT 

old: 00000627; PUSHAL L7™00000224 
news 000006273 BRW 00007800 
news 0000062A3 NOF 

new: 000006283 NOP 

new: 0000062C 3 NOP 

news 00007800; PUSHAL L™00000224 
news 000078063 DECL (RO) 

new: 000078083 BRW 00000621 
PATCH>UPDATE 


“PATCH-I-WRTFIL» urdatinga image file DBI? CEAGLEJAVERAGE.EXEs3 
PATCH>EXIT 


PATCH VERSION 2.0 15 MAR 80 


IMAGE FILE BEING FATCHED? "DB1 3 CEAGLE JAVERAGE.EXEs3* 
JOURNAL FILE? “0813 CEAGLEJAVERAGE.JNL#1° 
DATE/TIME OF PATCH; 21-MAR-1980 15338311.36 


PATCH)SET ECO 2 
PATCHS>SET MODE INSTRUCTION 


PATCH>EXAMINE AVERAGE+469 


AVERAGE +469? TSTL R4 
PATCH>DELETE/NOSYMBOLS 669 = ‘TSTL R4’ 
old; 000006469; TSTL R4 

news 000006693 NOF 

mews 0000066A3 NOF 

news 0000066B? NOF 

PATCH>UPDATE 


ZPATCH-I-WRTIFIL» wedatinga image file DRI‘ CEAGLEJAVERAGE.EXEs4 
PATCH>EXIT 


Figure 2-1 Sample Journal File 


As PATCH writes commands into the command procedure, all symbolic 
references are changed to absolute values. This happens because the 
steps that transform a program into an image file do not necessarily 
include the passing of symbol information to the image file. For 
example, if an image file has been linked without the /DEBUG 
qualifier, neither local nor global symbol information appears in the 
image's symbol table. Hence, when using PATCH'S CREATE command to 
create a command procedure, PATCH changes all symbolic references to 
absolute values in case the image file to which the command procedure 
is to be applied lacks symbol information. 
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PATCH also automatically abbreviates all commands in command 
procedures created using CREATE, to conserve space. 


2.4.2 Using Text Editors to Create Command Procedures 


You can use ae text editor, such as SOS, to construct command 
procedures. When you do so, the first entry in the command procedure 
must be the name of the input image file that is to incorporate’ the 
patches. Then enter PATCH command lines to the file in the order that 
you want PATCH to process them. For example: 


$ EXIT TEST.COM 

Ineut? DBISCTERHUNEITEST.COMs 1 
00100 AVERAGE .EXE $3 

00200 SET ECO 11 

00300 DEFOSIT/ASCIT 5046 = ’RUN’ 
00400 UFDATE 

00500) EXIT 

00600 “Z 

XE. 


This file, named TEST.COM, contains a patch, identified by ECO level 
ll, to be applied to the image file AVERAGE.EXE;3. To process the 
command procedure interactively, type: 


$ FATCH @TEST 


When using a text editor to create a command procedure, you can 
include symbolic references in the command procedure, if either of the 
following conditions is met: 


1. The symbolic names have been previously defined in the image 
file to which the command procedure is to be applied 


2. If you use the DEFINE command, that you are processing the 
entire command procedure and not selected patches contained 
in the command procedure 


You can also truncate commands to their accepted abbreviations when 
creating command procedures with text editors; however, for better 
comprehensibility and legibility, you should write the commands’ in 
long form. 


CHAPTER 3 


INVOKING AND TERMINATING PATCH 


You can use PATCH in three ways: (1) by invoking an interactive 
terminal session, .§ (2) by submitting a command procedure for 
interactive execution, or (3) by submitting a command procedure for 
‘batch mode processing. This chapter describes how to invoke and 
terminate PATCH for each of these execution modes. It also discusses 
the command qualifiers that PATCH’ recognizes. These qualifiers 
determine the file specifications for the journal file and output 
image file, and let you selectively apply individual patches to an 
image file. 


3.1 HOW TO INVOKE PATCH 


You can invoke PATCH by responding to the DCL prompt in any one of 
three ways: 


1. $ PATCH [/command-qualifier(s)] file-spec 

2. $ PATCH [/command-qualifier(s)] @file-spec 

3. $ SUBMIT file-spec 
The first method lets you invoke PATCH for an interactive terminal 
session; the second method lets you execute a command procedure 
interactively; and the third method lets you submit a command 
procedure for batch mode processing. 
For each of the above methods of invoking PATCH, if you fail to 
include the file specification on the initial command line, PATCH (or 
DCL) will prompt for it. 
You can also specify command qualifiers when you invoke PATCH. These 


qualifiers control the characteristics of the output files. See 
Section 3.2 for complete information on the PATCH command qualifiers. 


3.1.1 Invoking PATCH for Interactive Execution 


When you invoke PATCH for interactive execution, the file 
specification indicates the image file that you want patched. The 
specification must contain the file name; the remaining fields 


(device, directory, file type, and version) can be omitted. PATCH 
uses your default device and directory, assumes a file type of EXE, 
and uses the highest version of the specified file. 
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The following example shows one way of invoking PATCH for an 
interactive PATCH session: 


$ PATCH DBLICMASSEYICIRCLE 


In this example, PATCH is invoked to apply one or more patches to the 
image file CIRCLE.EXE. The image file is located on DBl:[MASSEY] and 
because the version field is omitted, PATCH updates the highest 
version of CIRCLE.EXE. After you press the RETURN key, PATCH displays 
the following introductory message: 


PATCH VERSION 2.0 15 MAR 80 
PATCH? 


The PATCH prompt indicates that PATCH is ready to accept input. 


3.1.2 Submitting a Command Procedure for Interactive Execution 


When you invoke PATCH to process a command procedure interactively, 
the file specification indicates the command procedure that contains: 


e The name of the image file that is to incorporate the patches 


e The PATCH commands that, when processed, perform the necessary 
changes to the image file 


The at sign (@) preceding the file specification tells PATCH that’ the 
file is a command procedure. The specification must contain the file 
name; the remaining fields (device, directory, file type, and 
version) can be omitted. PATCH uses your default device and 
directory, assumes a file type of COM, and uses the highest version of 
the specified file. 


The following example illustrates how to process a command _ procedure 
interactively. Read Section 2.4 for information on how to create a 
command procedure. 


$ PATCH @UPDATE.COM#3 
PATCH VERSION 2.0 15 MAR 80 


AVERAGEtG$ DIVL2 RS» (RS) 

AVERAGE+9$ CLRW (RIL) 

old? AVERAGE+9$ CLRW (Ril> 

news AVERAGE+9? CLRL (R11) 

“PATCH-I-WRTFIL» urdating image file [B12 CJAMES.FORT FROGS] AVERAG.EXE#10 
$ 


In this example, the command procedure UPDATE.COM is submitted for 
PATCH processing. The display indicates the patch and the file to 
which the patch is applied. The DCL prompt ($) indicates completion 
of the command procedure. 


You can also process selected patches in a command procedure. To do 
so, specify the /UPDATE command qualifier with the PATCH command. 
Read Section 3.2.2 for complete information, with examples, on this 
topic. 
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3.1.3 Submitting a Command Procedure for Batch Execution 
Use the third method when you want to submit a command procedure _ for 
batch execution. When you do so, the file specification indicates the 
name of the command procedure that contains: 

e The PATCH command which invokes PATCH 


e The name of the image file that is to incorporate the patches 


@ The PATCH commands that, when _ processed, perform the 
necessary changes to the image file. 


The SUBMIT command enters the command procedure in the batch job 
queue. You must specify the file name of the command procedure. The 
remaining fields (device, directory, file type, and version) can _ be 
omitted. The SUBMIT command uses your default device and directory, 
assumes a file type of COM, and uses the highest version of the 
specified file. 


See the VAX/VMS Guide to Using Command Procedures for detailed 
information and reference material on submitting files for batch 
execution. 


3.2 PATCH COMMAND QUALIFIERS 


The command qualifiers PATCH recognizes are /JOURNAL, /OUTPUT, and 
/UPDATE. These qualifiers are optional, but when used let you: 


e Override default file specifications 
e Process selected patches in a command procedure 


You can enter more than one command qualifier on a_e single _ line; 
however, each qualifier must be prefixed with the slash character (/). 


Table 3-1 lists and describes these qualifiers briefly. The sections 


following the table provide more detailed descriptions, with examples, 
of the qualifiers. 


Table 3-1 
PATCH Command Qualifiers 


| ormat ft iescription 


/JOURNAL [= file-spec] 












Overrides the default journal 
file specification 























/OUTPUT [= file-spec] the default 


specification 


Overrides 
image file 


output 








/UPDATE [= 





(eco-level [,...])] Processes’ only those patches 
associated with the specified ECO 


levels 
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3.2.1 Command Qualifiers for Overriding Default File Specifications 


The qualifiers that let you override default file specifications are 
/JOURNAL and /OUTPUT; the /JOURNAL qualifier lets you change the file 
specification of the journal file, and the /OUTPUT qualifier lets you 
change the file specification of the output image file. 


You do not have to specify all of the fields in the file specification 
of the /JOURNAL and /OUTPUT qualifiers. PATCH supplies the default 
values for the fields that you omit. The default values supplied by 
PATCH are listed and defined in Table 3-2. 


Table 3-2 
Default Values for the /JOURNAL and /OUTPUT Command Qualifiers 











Field Default Value 





Device and Process's current 
directory defaults 


File name Input image file name 






/JOURNAL [= file-spec] | File type JNL 


Version number l 











Device and Process's current 
directory defaults 
/OUTPUT [= file-spec] File name Input image 
file name 
File type EXE 
Version number 1 greater than the 


highest version 
of the input image file 





The following examples show some valid formats for invoking PATCH with 
the /JOURNAL and /OUTPUT command qualifiers: 


$ PATCH AVERAGE /JOURNAL = [81:CJACKSONITEST 


This command invokes PATCH for an interactive PATCH session with the 
image file AVERAGE.EXE. The /JOURNAL qualifier requests that the 
journal file be named TEST.JNL and that it be created in the 
DBl: [JACKSON] directory. 


$ PATCH PAYROLL /JOURNAL = TESTER /OUTPUT = TESTER 


This command invokes PATCH for an interactive PATCH session with the 
image file PAYROLL.EXE. The journal file and the output image file 
created by this session are named TESTER.JNL and TESTER.EXE, 
respectively and reside in the current default device and directory. 
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3.2.2 Command Qualifier for Processing Selected Patches 


The /UPDATE command qualifier lets you apply to an image file only the 
patches that correspond to the ECO levels specified with /UPDATE. 
When you use /UPDATE, the file specification can denote either a 
command procedure that contains the patches you want processed or an 
image file to which certain patches are applied. The formats for’ the 
use of the /UPDATE qualifier with the PATCH command are given below. 


For command procedures, use: 

$ PATCH /UPDATE = (eco-level [,...]) @file-spec 
For image files, use: 

S$ PATCH /UPDATE = (eco-level [,...]) file-spec 


When you use /UPDATE, specify at least one ECO level. If you’ specify 
more than one ECO level, separate the ECO levels with commas, and 
enclose the entire list within parentheses, 


3.2.2.1 Processing Selected Patches in Command Procedures - PATCH 
assumes that the file is a command procedure if the file specification 
is preceded by an at sign (@). PATCH reads the command procedure’ and 
executes those patches corresponding to the ECO levels specified with 
the /UPDATE qualifier. The first entry in the command procedure is 
always the name of the image file to which the patches are to be 
applied. 


As mentioned in the section that describes creating command procedures 
(Section 2.4.2), if a command procedure contains symbolic references, 
you should not try to apply selected patches from that command 
procedure to an image file. This is because PATCH parses each patch 
in the command procedure to determine if it is represented by an _ ECO 
level specified with the /UPDATE command qualifier. During the parse 
operation, if PATCH encounters a symbol defined in a patch that is not 
to be applied to the image file, it reports an error in the command 
procedure. 


When PATCH reads the command procedure, it displays on the terminal 
the following information: 


1. The PATCH introductory message 
2. Patches applied to the image file 
3. ECO error messages 


a. ECO levels specified with /UPDATE, but already applied to 
the image file . 


b. ECO levels present in the command procedure, but not 
specified with /UPDATE 


INVOKING AND TERMINATING PATCH 


The following example shows how PATCH executes selected patches in the 
command procedure TEST1.COM: 


$ FATCH /UPDATE = (10912) @CJOHNSON.FORTRANITEST1.COM 
FATCH VERSION 2.0 15 MAR 80 


DRM1: OEFDE4800 

Old? ORM1$ OEFDE4800 

mew? DRM1$ 060000000 

ZPATCH~I-WRTFIL» urdatingad image file DBLICMATTHEWS.FORTRANIPROGB.EXE SS 
ZPATCH-I-UPDATE? ratch with eco 11 isnored due to urdate aualifier 
AMSTR+50$ 68504005 

Qld: AMSTRtSO$ 68504005 

new: AMSTR+503 00000000 


ZPATCH~-I-WRTFIL» urdating image file DBL? CMATTHEWS.FORTRANIFROGR.EXEs8 
$ 


This PATCH command executes the command procedure [JOHNSON.FORTRAN] 
TEST1L.COM in interactive mode. The /UPDATE qualifier requests that 
only the patches identified by the ECO levels 10 and 12, contained in 
TEST1.COM, be applied to the image file PROGB.EXE in the directory 
[MATTHEWS.FORTRAN]. The display indicates that the patches specified 
with /UPDATE were successfully applied to PROGB.EXE and reports that 
the patch identified by ECO level 11 was not applied because that ECO 
level was not specified with the /UPDATE qualifier. 


Note that when you execute command procedures interactively, the 
/UPDATE qualifier must precede the name of the command procedures. 


If you do not include the /UPDATE qualifier, PATCH processes all 
patches in the command procedure. 


3.2.2.2 Processing Selected Patches Interactively - When you’ include 
the /UPDATE qualifier with the input image file, PATCH processes only 
those patches represented by the ECO levels specified with /UPDATE. 
If, while editing the image file, you define an _ ECO level not 
specified with the /UPDATE qualifier, PATCH ignores the subsequent 
commands and displays an informational error message. For example: 


$ FATCH /UPDATE = (294) CIRCLE 
FATCH VERSION 2.0 15 MAR 80 


FATCH? SET ECO 2 


+ 


PATCH? UPDATE 


¢ 


PATCH? SET ECO 3 


ZPATCH-I-UPDATEs ratch with eco level 3 ignored due to uedate aualifier 
FATCH> SET ECO 4 


In the above example, PATCH allows processing of the patch identified 
by the ECO level 2; however, when you try to define ECO level 3, 
PATCH displays a message indicating that the patch cannot be _ applied 
because it was not specified with /UPDATE. 


INVOKING AND TERMINATING PATCH 


Note also that if you specify an ECO level with /UPDATE, but do not 
set that ECO level during the PATCH session, PATCH issues. an 
informational error message when you exit from PATCH. 


3.3 HOW TO TERMINATE PATCH 


To terminate a PATCH session, type the EXIT command. This command 
passes control back to the command interpreter. Keep in mind, though, 
that to create an output image file, you must type the UPDATE command 
before exiting from PATCH. For example: 


PATCH> UPDATE 
ZPATCH-I-WRIFILy urdating image file DB2$ COARNELLIBINDER.EXE310 
PATCH> EXIT 

$ 


If you omit the UPDATE command before you type EXIT, control is passed 
to the command interpreter, but the output image file is not written. 
The commands are still recorded in the journal file. 


To interrupt program execution, type CTRL/Y (echoed as “Y). This 
command also passes control back to the command interpreter. To 
continue patching, type the CONTINUE command. For example: 


FATCH? “Y 

$ SHOW TIME 
3-AUG-1979 10335353 

$ CONTINUE 

PATCH? 


You can also terminate PATCH by typing CTRL/Z iechiord. as “Z). This is 
equivalent to typing EXIT. 


CHAPTER 4 


SYMBOLS 


PATCH is a symbolic utility. This means that you can pass_ symbol 
information to PATCH or define new symbols during a PATCH session, 
then use that symbolic information as a reference tool. The symbol 
information available to PATCH is determined by certain qualifiers you 
include or exclude when compiling or assembling and linking a program. 


4.1 SYMBOLS RECOGNIZED BY PATCH 
PATCH recognizes the following symbol types: 
e Global symbols 
e Local symbols 
@e Module names, program section names, and routine names 
e Universal symbols 
e Symbolic instruction labels 
e Symbols defined with the PATCH DEFINE command 


PATCH alSo recognizes patch area _ symbols. This symbol type is 
described in Chapter 5. 


PATCH cannot access local labels in VAX-11 MACRO programs. Local 
labels are symbols that consist of a number (0 through 65535) followed 
by the dollar sign ($). 


4.1.1 Global Symbols 


Global symbols are symbols defined in one module to be accessed by any 
number of other modules. 


You indicate a global symbol in your source program by delimiting it 
with a special operator. This operator depends on the language in 
which your program is written. For example, in VAX-11 MACRO, you 
define a global symbol by using double colons (::) or equal signs 
(==). (Individual language reference manuals contain information. on 
defining global symbols.) 


To pass global symbol information to PATCH, specify the /DEBUG 
qualifier when you link your program. (See the appropriate language 
manual for complete information on passing global symbols.) 
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4.1.2 Local Symbols 


Local symbols are symbols that are defined in a particular module and 
can be accessed only by that module. 


You indicate a local symbol in your source program by delimiting it 
with a special operator. This operator depends on the language in 
which your program is written. For example, in VAX-11 MACRO, you 
define a local symbol by using a _ single colon or _ equal sign. 
(Individual language reference manuals contain information on defining 
local symbols.) 


To pass local symbol information to PATCH, you must include the 
debugger when you assemble or compile and link your program. (See the 
appropriate language manual and the VAX-1l Linker Reference Manual for 
more information on passing local symbols.) When you run PATCH, use 
the SET MODULE command to enter local symbol information into’ the 
symbol table. 


4.1.3 Module Names, Program Section Names, and Routine Names 
Module names, program section names, and routine names are always 
passed to PATCH unless you specify /NODEBUG and /NOTRACEBACK at link 


time. When these qualifiers are specified, no symbol information is 
passed to PATCH. 


To limit symbol information to only module names, program section 


names, and routine names, link your program with the /TRACEBACK and 
/NODEBUG qualifiers (these are the default qualifiers). 


4.1.4 Universal Symbols 
Universal symbols are: 
e A subset of the global symbols of a shareable image 


e The only type of symbol PATCH can reference when patching a 
shareable image 


Any global symbol is eligible to be a universal symbol. However, you 
typically declare only a limited subset of global symbols to be 
universal, because not all symbols are required for a particular 
application and partial symbol declaration reduces system overhead. 


To declare a symbol to be universal, specify the option UNIVERSAL= in 
the options file when you link your program. For example: 


$ LINK/SHAREABLE FROGA»FROGB/OPTIONS 


PROGB.OPT 


UNIVERSAL=A,B,C 





SYMBOLS 


In the above example, the symbols A, B, and C are declared universal 
in the shareable image PROGA. The file named PROGB.OPT is the linker 
options file in which the universal symbol declarations are contained. 


To reference universal symbols in a shareable image, observe the 
following guidelines: 


e If the shareable image is position independent, all 
relocatable universal symbols are based at zero (not at 
hexadecimal 200, as the linker map may suggest). Therefore, 
when you evaluate a universal symbol, add 200 to the value 
displayed by the EVALUATE command. 


e If a symbol is in a transfer vector and has been declared 
universal by use of the .TRANSFER directive, the value of the 
symbol in the shareable image's user symbol table (UST) is the 
address of the transfer vector, not the actual routine address 
in the image. 


Thus, for PATCH to reference locations symbolically in a _ non-zero- 
based shareable image that is position independent, you must specify 
the symbol as: 


symbol + <base> 


The following example illustrates the proper use of universal symbols 
for patching a shareable image. 


$ MACRO CHAL1 

$ LINK/SHAREABLE CHAL1»xX/OF TIONS 
UNIVERSAL =LBRSBENN 

$ FATCH CHAL1 


FATCH VERSION 2.0 15 MAR 80 


4ZPATCH~-I-NOLCL» imade does not comtain local symbols 
FATCH: EXAMINE LERSBENN 

“ZPATCH-E-NSADDIR: address 00000050 is mot within imase 
PATCH? EVALUATE LBRSEENN 

00000050 

PATCH? EXAMINE/WORD 250 

000002503 OF FC 

PATCH? EXAMINE/INSTRUCTION 

000002523 BRW QOOOOOSEE 

PATCH? EXAMINE/INSTRUCTION #8EE 

OOOOOSEE: SUBL2 #08+SF 


In this example, the first EXAMINE -command tries unsuccessfully to 
display the contents of the universal symbol LBRSBENN. The EVALUATE 
command verifies that LBRSBENN is memory location 50. Because’ the 
shareable image is position independent, you must add the value 200 to 
location 50 and the word of data in the resulting location (location 
250) is displayed; this data represents the entry point register save 
mask of the routine LBRSBENN. To display the first instruction in 
LBRSBENN, the EXAMINE/INSTRUCTION command is used. In this case, the 
branch instruction displayed is the transfer to the actual start of 
LBRSBENN. Examining the destination of the branch instruction 
provides the first instruction in LBRSBENN. 
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4.1.5 Symbolic Instruction Labels 


Symbolic instruction labels are 1- to 15-character symbols having the 
following characteristics: 


® They must start with an alphabetic character (labels Such as 
10$ are invalid for use with PATCH) 


® They can consist of alphanumeric characters, dollar signs (S$), 
and/or underscores (_) 


A symbolic instruction label lets you associate a specific name with a 
particular location without knowing the numeric address of the 
location. This situation generally arises when: 


1. A series of instructions is inserted, replaced, or deposited 
into the existing code (See Chapter 8) 


2. PATCH places the new instructions in the current patch area 
and generates branch instructions to and from the patch area 
to maintain the logical flow of program execution (See 
Chapter 5) 


3. Of the new instructions being added, one of the instructions 
references another one 


‘Because you do not know the exact location of the instruction being 
referenced, you can use a symbolic instruction label to reference the 
location. For example: 


PATCH> INSERT/INSTRUCTION 350 
OLD? “TSTL R3’ 

OLD> EXIT 

NEW: “BEQL NONE’ 

NEW> “MOVL R4*R0° 

NEW> “DIVL2 ROsR1’ 

NEW> “MULL2 R2»R1° 

NEW> “NONE? RET’ 

NEW> EXIT 


Here, a group of instructions is inserted after location 350 by means 
of a patch area. Note that the symbolic instruction label NONE is 
used in the first instruction to reference the fifth instruction. The 
label NONE is used because the exact placement of these instructions 
is not known. 


Side Effect of Using Symbolic Instruction Labels: A side effect of 
using symbolic instruction labels is that once a symbolic instruction 
label is assigned a location, the label always’ references’ that 
location, even if the contents of the location are moved. For 
example, suppoSe you have the following code in your program: 


TEST. EXE 
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TSTL 
MOVL 


R5 
R2,R3 


In this situation, the symbolic instruction label LBL3 is assigned to 
location 552, and a preceding instruction (BEQL LBL3) references LBL3. 
Later, you discover that the TSTL R5 instruction is wrong and perform 
the following patch: 


PATCH? REPLACE/INSTRUCTION S50 
OLD “TSTL RS’ 


OLD EXIT 

NEW? “CMPL RSs RS’ 

NEW? EXIT 

old: 000005503 TSTL RS 
olds 1. BL.3 ¢ MOVL R2rR3 


news 0000035503 BRW 00007800 
news 000005533 NOP 

news 000005543 NOF 

news 000078003 CMPL RO» RS 
news 000078033 MOVL. R29R3 
news 00007806; BRW OQ000SSS 


During the replacement operation, the following occur: 


e The CMPL R5,R6 instruction requires more bytes than the MTSTL 
R5 instruction, thus preventing a_ simple replacement from 
being performed. 


e The CMPL R5,R6 instruction is moved to the current patch area 
and a branch to the patch area replaces the TSTL_ R5 
instruction. 


e The branch instruction needed to reroute the logical flow of 
execution to the patch area also requires more bytes than 
those occupied by the TSTL R5 instruction. 


e The instruction that follows the TSTL R5 instruction is also 
moved to the patch area to make room for the branch 
instruction. (This is the MOVL R2,R3 instruction, which has 
the symbolic instruction label LBL3 assigned to its location.) 


e The branch instruction is inserted into the area left blank by 
the deletion of the MTSTL R5 instruction and removal of the 
MOVL R2,R3 instruction to the patch area. 


e NOP instructions are used to fill the locations not used by 
the branch instruction. 


As a result of this patch, the symbolic instruction label LBL3_ still 
references location 552, which is the middle of the branch 
instruction. If you were to examine LBL3, the following instruction 
would be displayed: 


PATCHs EXAMINE/INSTRUCTION LBL3 
LBL 3 MNEGD #01401 
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To remedy the situation, modify all instructions that reference LBL3, 
as demonstrated below: 


PATCH> REPLACE/INSTRUCTION XX 
OLD> ‘BEQL LBL3’ 

OLDS’CLRL -(R6)’ 

OLD> EXIT 

NEW> ‘“BNEQ LBEL2’ 

NEW> “BRW 7803 

NEW> ‘LBL23 CLRL -(RG6)’ 

NEW> EXIT 


To correct the reference made to the MOVL R2,R3 instruction and_ to 
maintain a logical flow of program execution, the BEQL LBL3 
instruction and CLRL -(R6) were replaced with complementary 
instructions: 


Instruction Description 
BNEQ LBL2 branch if not equal to label LBL2 
BRW 7803 unconditional branch to location 7803 


Note that the unconditional branch instruction uses a word 
displacement to ensure that the branch can reach its destination. 


4.1.6 Symbols Defined with the DEFINE Command 


When you run PATCH, you can assign a symbolic name to a location or 
value by using the DEFINE command. This command lets you supplement 
or override existing symbols in your image for the duration of the 
PATCH session. 


See the DEFINE command in Chapter 8 for more details about this 
command. 


4.2 THE PATCH SYMBOL TABLE 


When PATCH starts up, it builds a symbol table in which global 
symbols, local symbols, universal symbols, module names, program 
section names, routine names, patch area symbols, and symbols’ defined 
with the DEFINE command are placed. Global and local symbols are 
placed in the symbol table if you followed the rules for passing these 
symbols. If you did not pass these symbols, PATCH displays one or 
both of the following informational error messages when it is invoked: 


%PATCH-I-NOGBL, some or all global symbols are not accessible 
$PATCH~I-NOLCL, image file does not contain local symbols 


PATCH uses symbol table information to translate symbols into values 
and values into’ symbols. The rules governing symbol and value 
translations are discussed in Section 4.4. 


PATCH has no knowledge of symbol information that is not present in 
the symbol table. To confirm that the symbol table contains the 
appropriate entries use the SHOW MODULE command. This command reports 
the current symbol table status. For more information on the SHOW 
MODULE command, see Chapter 8. 


SYMBOLS 


4.3 PATHNAMES 


Some symbols may be multiply defined within your image file. To find 
a particular location that is defined by a multiply defined symbol, 
you must create an unambiguous path that directs PATCH to the location 
you want to reference. 


A pathname is a symbolic expression that uniquely identifies a 
location within your image file. A pathname consists of the following 
elements: 


scope\symbol-name + offset-value 
scope 


Identifies a particular module within your image file in which 
PATCH searches for the symbolic name supplied. The backslash 
character (\) is a required delimiter. 


Supplying a scope is unnecessary when: (1) all the symbol names 
within your file are unique; (2) the scope is already set, by 
use of the SET SCOPE command, to the region you want to 
reference; or (3) the symbol being accessed is a global symbol. 


symbol-name 


Identifies a particular location within your image file. Symbol 
names can be global symbols, local symbols, or symbols you 
defined with the DEFINE command. 


The symbol name is the only element that must always be supplied 
in order to find that location. 


+ offset-value 


Specifies a positive or negative numeric value, in the current 
radix, appended to the symbol name. The offset value is used to 
reference unlabeled locations. 


The following example demonstrates the use of a pathname: 


PATCH> EXAMINE/INSTRUCTION REM_MODI\CRM_STRT+1A 
REM.MODINCRMSTRT+1A% CLRQ RO 


In this example, the EXAMINE/INSTRUCTION command requests that’ the 
contents of location CRM_STRT+1A, in the module named REM MOD1, be 
displayed as a VAX-11 MACRO instruction. 


4.4 TRANSLATING SYMBOLS AND VALUES 


PATCH follows a specific sequence of steps to translate an address 
value to a symbol or a symbol to an address value. The following 
sections explain the algorithms PATCH’ uses to compute these 
translations. 


4.4.1 Translating Symbols into Address Values 


PATCH'sS translation of symbolic entries into values is controlled by 
the GLOBALS-NOGLOBALS and SCOPE-NOSCOPE modes. The following steps 
outline the procedure PATCH uses to perform this translation. 
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1. First, PATCH compares the symbolic entry with all user-defined 
symbols for an exact match. 


2. If step 1 fails, PATCH checks the status of the 
GLOBALS-NOGLOBALS mode setting. If the mode is set to 
GLOBALS, PATCH compares the symbolic entry as you entered it 
with the symbols in the symbol table, looking for an exact 
match. That is, when PATCH searches the symbol table for a 
match, it does not’ prefix the contents of the scope to the 
symbolic entry. 


3. If step 2 fails, or if the mode is not set to GLOBALS, PATCH 
checks the status of the SCOPE-NOSCOPE mode setting. If the 
mode is set to SCOPE, PATCH prefixes the contents of the scope 
setting to the symbolic entry and searches the symbol table 
for an exact match. 


4. If step 3 fails, or if the mode is not set to SCOPE, PATCH 
prefixes the contents of the scope (based on the current PC) 
to the symbolic entry and searches the symbol table for an 
exact match. 


5. If step 4 fails, PATCH again checks the status of the 
GLOBALS-NOGLOBALS mode setting. If the mode is set to 
NOGLOBALS, PATCH compares the symbolic entry as you entered it 
with the symbols in the symbol table, looking for an exact 
match. That is, when PATCH searches the symbol table for a 
match, it does not prefix the contents of the scope setting to 
the symbolic entry. (Note that this is the same procedure as 
step 2, except the mode is set to NOGLOBALS.) 


If the translation is successful, PATCH evaluates the expression in 
which the symbolic entry appears. If the translation fails, PATCH 
issues the following error message to indicate that it could not 
evaluate the symbolic entry: 


%PATCH-W-NOSYMBOL, no such symbol 'symbolic-entry' 


4.4.2 Translating Address Values into Symbols 


PATCH's translation of address values into symbolic entries is 
governed by the SYMBOLS-NOSYMBOLS mode. The following steps outline 
the procedure PATCH uses to perform this translation: 


1. First PATCH compares the address value with all user-defined 
symbols for an exact match. 


2. If step 1 fails, PATCH compares the address value with the 
global and local symbol definitions, looking for an exact 
match. 


3. If step 2 fails, PATCH searches all symbol definitions, 
looking for the one whose corresponding address value is 
closest to, but less than, the specified value. PATCH 
rejects a symbol definition as being closest to the address 
value when the difference between the symbol and the address 
value is greater than or equal to hexadecimal 100. 


If the translation is successful, PATCH evaluates the expression in 
which the address value appears and reports the address value in terms 
of the corresponding symbol name. If the translation fails, PATCH 
still evaluates the expression in which the address value appears; 
however, PATCH reports the address value as a numeric address in terms 
of the current radix. 


4-8 


CHAPTER 5 


PATCH AREA 


Patch area is read/write memory located within or at the end of an 
image file used to store additional instructions or data entries. 
Default patch area, that is, patch area created by PATCH, is always 
appended to the end of an image file. User-defined patch area, on the 
other hand, can be located anywhere within the image file. 


This chapter discusses the two types of patch area, the patch area 
string descriptor used to keep track of the status of the patch area, 
the patch area symbols generated by PATCH, and the commands’ that 
affect patch area. 


5.1 DEFAULT PATCH AREA 


The default patch area is area automatically supplied by PATCH. 
Generally, the default patch area is expandable. It is limited by 
available disk space during PATCH execution and the value of the 
SYSGEN virtual page count parameter at run time, 


PATCH allocates the default patch area one page at a time, as 
necessary. For example, if you are inserting additional instructions 
into the image file, PATCH allocates another page of the default patch 
area if the existing default patch area is too small to accommodate 
the new instructions. 


By convention, whenever you patch an image file and the patches 
require the usSe of a patch area, those patches are placed in the 
default patch area. However, in some instances, the default patch 
area cannot be used to store patches. Such is the case for device 
driver images and shareable images that have been linked with other 
images. 


If you need to patch a device-driver image or a shareable image that 
has been linked with other images, you should use a user-defined patch 
area as described in the following section. 


5.2 USER-DEFINED PATCH AREA 


A user-defined patch area is area you create in the source code. This 
patch area is located within the boundaries of the image file; PATCH 
does not extend the length of the image file to accommodate a 
user-defined patch area. Also, a user-defined patch area is of a 
fixed size; PATCH cannot increase the size of a user-defined patch 
area to accommodate additional patches. 
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You should use a user-defined patch area to store additional code when 
patching device-driver images and shareable images. Section 5.2.1 
below explains why a user-defined patch area is preferred in these 
cases over the default patch area. Sections 5.2.2 through 5.2.4 then 
describe how to create a user-defined patch area, access it, and 
terminate the use of it. 


5.2.1 When to Use User-Defined Patch Area 


As mentioned above, you should use a user-defined patch area _ rather 
than the default patch area when patching an image whose total size 
cannot be increased. Examples of this type of image are device-driver 
images and shareable images. 


A device-driver image contains, at the start of the image,.a_ location 
that defines the total length of the driver. When the device driver 
is loaded, the driver loader looks at this location to determine the 
amount of space to allocate to the device-driver. The fact that PATCH 
extends the device-driver image when default patch area is used means 
that the total length of the device-driver image increases. However, 
PATCH does not recognize the location that contains the length of the 
device-driver, nor can PATCH modify the contents of that location if 
it extends the device-driver image. Thus, a subsequent running of a 
device driver that uses default patch area causes the patch area to be 
truncated. 


Similarly, a program linked with shareable images must know, at link 
time, the amount of address space (in pages) occupied by each 
shareable image. When the program is linked, it leaves virtual 
address space in the image file in which the shareable images will be 
placed. If the length of a shareable image should grow after the 
program is linked, then at run-time, the patch area will overlay part 
of the shareable image. 


5.2.2 Creating User-Defined Patch Area 


To create a user-defined patch area, set aside area at assembly or 
compile time. The following example illustrates how to set aside 
patch area in a VAX-11 MACRO program. The numbers to the right of the 
example are keyed to the descriptions below. 


PATSIZE = size-in-bytes-of-patch-area 1) 
PATDESC:: 

- LONG PATSIZE @ 

- LONG PATADR 
PATADR: : 

-BLKB PATSIZE 3) 


In the preceding example, you: 
0 Define a size for the patch area 


@ Create a patch area descriptor that specifies the size and 
first free byte of the patch area 


© Define a symbol to represent the starting address of the 
patch area 
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5.2.3 Accessing User-Defined Patch Area 


‘After creating a user-defined patch area, you can access’ that patch 
area by issuing the SET PATCH AREA command. This command is fully 
described in Chapter 8. 


5.2.4 Terminating the Use of User-Defined Patch Area 


To terminate the use of a user-defined patch area, issue the CANCEL 
PATCH AREA command. This command resets the current patch area to the 
default patch area (See Chapter 8). 


You can also reset the patch area from one user-defined patch area _ to 
another user-defined patch area by issuing the SET PATCH _AREA command. 
(This command is fully described in Chapter 8.) 


5.3 PATCH AREA DESCRIPTOR 


A patch area descriptor is a record of the current status of a patch 
area. The first longword contains the current size (in unused bytes) 
of the patch area, and the second longword contains the address of the 
first free byte of the patch area. You can observe the status of the 
current patch area by issuing the SHOW PATCH_AREA command. For 
example: 


PATCH> SHOW FPATCHUAREA 
current ratch area size} 00000200 


current Patch srea address 00007800 


All patch area, whether it is user-defined or default patch area, has 
a descriptor associated with it. Any time a command is executed that 
affects patch area, the patch area descriptor is updated to reflect 
the modifications. 


5.4 PATCH AREA SYMBOLS 


DIGITAL reserves the use of certain PATCH symbols to represent’ the 
start of particular patch areas. These symbols range from PAA through 
PZZ and are referred to as patch area_ symbols. You are not 
recommended to use these symbols. However, you can create your own 
patch area symbols using the ALIGN command. This command lets you 
assign symbolic names to the starting address of the default patch 
area and to all the user-defined patch areas. This command is fully 
described in Chapter 8. 


5.5 COMMANDS THAT AFFECT PATCH AREA 


The commands that affect patch area are INSERT/INSTRUCTION, 
REPLACE/INSTRUCTION, DEPOSIT/PATCH_AREA, and ALIGN. The following 
four sections briefly describe how these commands affect the patch 
area. 
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5.5.1 INSERT/INSTRUCTION Command 


When you uSe the INSERT/INSTRUCTION command, PATCH automatically 
stores the new instructions in patch area and generates unconditional 
branch instructions to reroute the logical flow of execution to the 
patch area, then back to the inline code. 


Occasionally, when you insert one or more new instructions into your 
code, the following events may occur: 


e A branch-type instruction is moved to the current patch area 


e The patch area is far enough away to prevent the branch-type 
instruction from reaching its destination 


When these events occur, the INSERT/INSTRUCTION command recalculates 
the relative displacement of the branch-type instruction to allow the 
branch to reach its destination. For example, suppose the insertion 
of a new instruction causes the BRW 200 instruction to be moved to 
patch area. However, once the BRW 200 instruction is in the _ patch 
area, the word displacement is not large enough to reach location 200. 
The INSERT/INSTRUCTION command then recalculates the word displacement 
to allow the branch to succeed. 


Be aware that PATCH always completes a patch with a branch instruction 
to the inline code, even if the last instruction of the patch is an 
unconditional branch instruction. 


See Chapter 8 for more information on the INSERT command. 


5.5.2 REPLACE/INSTRUCTION Command 


When you use the REPLACE/INSTRUCTION command, PATCH automatically 
stores the new instructions in patch area only if the new instructions 
occupy more bytes in memory than the instructions being replaced. If 
patch area is used, PATCH generates branch instructions to and from 
the patch area to maintain the correct flow of program execution. 


As with the INSERT/INSTRUCTION, the REPLACE/INSTRUCTION command can 
also cause a branch-type instruction to be moved to the patch area. 
If the new location of the branch-type instruction is too far away to 
allow the branch to reach its destination, the REPLACE/INSTRUCTION 
command recalculates the relative displacement of the branch-type 
instruction to allow the branch to reach its destination. (Read the 
previous section to see exactly when and how branch-type instructions 
are modified.) 


When you replace numeric or ASCII data, the new data is truncated if 
it exceeds the length of the data that it is to replace. (That is, 
patch area is not used.) 


Be aware that PATCH always completes a patch with a branch instruction 
to the inline code, even if the last instruction of the patch is an 
unconditional branch instruction. 


See Chapter 8 for more information on the REPLACE command. 
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5.5.3 DEPOSIT/PATCH_AREA Command 


The DEPOSIT/PATCH AREA command uses patch area to. store additional 
instructions or data; however, PATCH does not automatically generate 
branch instructions to and from the patch area when ‘you deposit the 
new data. You must insert the branch instructions manually. You must 
also recalculate the relative displacements of all branch-type 
instructions affected by the insertion of new data or instructions. 
See Chapter 8 for more information on the DEPOSIT command. 


5.5.4 ALIGN Command 


Use the ALIGN command to allocate space for the default patch area in 
an image file that has not previously been patched or to redefine the 
first free byte of the current patch area. See Chapter 8 for more 
information on the ALIGN command. 


CHAPTER 6 


ENTRY AND DISPLAY MODES 


Entry and display modes determine how PATCH interprets your commands 
and displays its output. The entry and display modes are grouped into 
four functional categories: context, length, radix, and symbol 
search. The context modes control whether addresses can be 
represented symbolically, whether instructions can be represented as 
VAX-11 MACRO instructions, and whether data can be represented as 
ASCII text. The length modes determine the length in which data 
entries are represented. The radix modes determine the base in which 
addresses and data entries are represented. The symbol search modes 
control how PATCH translates symbols into addresses and vice versa. 


Table 6-1 defines the purpose of each mode. Sections 6.1 and 6.2, 
which follow the table, describe the techniques for establishing a 
particular mode setting and the rules to follow when specifying the 
entry and display modes. 


Table 6-1 
Entry and Display Modes in PATCH 


initial 
Category Mode Description Default 


Context INSTRUCTION Accepts or displays your data as 
VAX-11 MACRO instructions. If you 
enter old or new data, and this mode 
is set, the instructions must be en- 
closed within apostrophes or quota- 
tion marks. 






















NOINSTRUCTION 














NOINSTRUCTION | [Inhibits the entry or display of data 


as VAX-11 MACRO instructions. 
This is the initial default condition. 


Accepts or displays your data as ASCII 

characters. If you enter old or new data, 

and this mode is set, the data must be 

enclosed within apostrophes or quota- 

tion marks. NOASCII 
NOASCII Inhibits the entry or display of your 

data as ASCII characters. This is the 

initial default condition. 


NOSYMBOLS Inhibits the display of addresses 
symbolically. 
SYMBOLS 
SYMBOLS Displays addresses symbolically. 
This is the initial! default condition. 


(continued on next page) 
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Table 6-1 (Cont.) 
Entry and Display Modes in PATCH 


Initial 


Category Description Default 
meng BYTE Accepts or displays a byte of data 
LONG 








Accepts or displays a word of data 


LONG Accepts or displays data in longword 
lengths. This is the initial default 


condition. 


Accepts or displays data and addresses 
in octal representation. 


Accepts or displays data and addresses 
in decimal representation. 


















OCTAL 






DECIMAL HEXADECIMAL 


HEXADECIMAL Accepts or displays data and addresses 
in hexadecimal representation. This is 


the initial default condition. 








Symbol NOSCOPE 
Search 


Inhibits using SCOPE’s contribution 
to a pathname, and reverts to <null> 
scope. 

SCOPE Allows using SCOPE’s contribution 
to a pathname. This is the initial 
default condition. 


GLOBALS Allows the use of the symbolic entry 
as the first pathname in a search. 


NOGLOBALS 


NOGLOBALS Allows the use of the symbolic entry 
as the /ast pathname in a search. This 
is the initial default condition. 


ee sarnmeramanne en heerremsemuncrreerren CTE 


ENTRY AND DISPLAY MODES 


6.1 MODES AND MODE QUALIFIERS 


You can modify the mode settings with the SET MODE and CANCEL MODE 


commands or by issuing an alternative mode qualifier on a command 
line. For example: 


FATCH> SET MODE INSTRUCTION 
PATCH? DELETE 400=‘MOVL (R46)»(RS)/ 


or 


PATCH? DELETE/INSTRUCTION 400=’MOVL (R46)* (RS) ’ 


The above examples are roughly equivalent. The only difference is 
that in the first example INSTRUCTION mode becomes a default setting, 
whereas in the second example INSTRUCTION mode is a temporary setting 
effective only for that command line. The next command line adheres 
to the current mode settings. 


To examine the status of the current modes, issue the SHOW MODE 
command. 


6.2 SPECIFYING ENTRY AND DISPLAY MODES 


This section discusses the rules for specifying the entry and display 
modes. Entry and display modes control the format of your patches. 
For example, to deposit a VAX-11 MACRO instruction, the INSTRUCTION 
mode must be set, whereas to deposit some ASCII text, the ASCII mode 
must be set. 


6.2.1 Context Modes 
The context modes are: 


INSTRUCTION NOINSTRUCTION 
ASCII NOASCII 
SYMBOLS NOSYMBOLS 


These modes serve as ON-OFF switches. For example, INSTRUCTION mode 
attempts to display the contents of one or more locations as VAX-11 
MACRO instructions. NOINSTRUCTION mode then inhibits the ability to 
display the contents of one or more locations as VAX-11 MACRO 
instructions. 


The following subsections describe each of the context modes, 
including the function of each mode and the rules PATCH follows when a 
particular mode is set. 


6.2.1.1 INSTRUCTION-NOINSTRUCTION Modes - The INSTRUCTION- 
NOINSTRUCTION modes control whether data can be entered and displayed 
as VAX-11 MACRO instructions. 
When INSTRUCTION mode is set, PATCH: 

e Accepts and displays data as VAX-11 MACRO instructions. 

e Ignores the current length mode when accepting or displaying 


instructions. PATCH increments the current address by the 
number of bytes occupied by the instruction. 
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Invokes, when you use the REPLACE, INSERT, or 
DEPOSIT/PATCH_AREA command, an automatic fitting mechanism 
that takes symbolic instructions and fits them into the 
locations indicated. This fitting mechanism may include 
moving some instructions into the current patch area and 
inserting branches to them, or replacing unused bytes with no 
operation instructions (NOPs). 


e Requires that all symbolic instructions entered as input must 
be enclosed within quotation marks or apostrophes. (See 
"Entering VAX-11 MACRO Instructions" in Section 7.4 for more 


information.) 


When NOINSTRUCTION mode is set, PATCH accepts and displays data 
according to the current radix, length, and ASCII-NOASCII mode 


setting. 


6.2.1.2 ASCII-NOASCII Modes - The ASCII-NOASCII modes control whether 
data can be entered and displayed as ASCII data. 


When INSTRUCTION mode is set, PATCH ignores the ASCII-NOASCII- setting 
and accepts and displays data as VAX-11 MACRO instructions. 


When ASCII and NOINSTRUCTION modes are set, PATCH: 


e Requires that all ASCII data 


entered as input be enclosed 


within quotation marks or apostrophes. (See "Entering ASCII 
Data strings" in Section 7.3 for more information.) 


e Displays an error message if you enter a string of numbers not 
enclosed within quotation marks or apostrophes. 


e Truncates an ASCII input string if the string exceeds’ the 
limit imposed on it by the current length mode. PATCH 
truncates input strings by discarding excessive characters 


from the right. 


e Displays ASCII output strings according to the current length 


mode. For example: 


PATCH> EXAMINE/BYTE/ASCII 
00000675: I 


FATCH> EXAMINE/WORD/ASCII 
000006753 Ip 

PATCH> EXAMINE/LONG/ASCII 
000006753 IDLE 


e Ignores the current radix mode 
data. 


When NOASCII and NOINSTRUCTION modes 
displays data according to the current 


6.2.1.3 SYMBOLS-NOSYMBOLS Modes - The 


675 
675 


675 


when accepting or displaying 


are set, PATCH accepts”) and 
radix and length mode settings. 


SYMBOLS-NOSYMBOLS modes control 


whether addresses are displayed by pathnames or symbols, rather than 


by numeric addresses. (See Section 
pathname.) 


4.3 for the definition of a 
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When SYMBOLS mode is set, PATCH: 


e Displays all locations by their respective pathnames' or 
symbols 


e Accepts pathnames as input 


When NOSYMBOLS mode is set, PATCH displays all locations by their 
numeric addresses. You can still enter a pathname as input to PATCH; 
however, PATCH displays that location by its numeric address. 


Chapter 4 describes the rules PATCH follows when it translates address 
values into symbols and vice versa. 


6.2.2 Length Modes 


The modes that specify length are BYTE, WORD, and LONG. They denote 
how many bytes (1, 2, or 4) in memory are available to store a given 
data item. The following rules apply to the length modes: 


@e VAX-11 PATCH ignores the current length mode and accepts. or 
displays instructions in their entirety. (This condition 
exists only when INSTRUCTION mode is set.) 


e Truncate the most significant bit positions of numeric data 
that exceed the boundary imposed on it by the current length 
mode. (This condition exists only when NOINSTRUCTION and 
NOASCII modes are set.) PATCH also issues an informational 
error message. For example: 


PATCH? DEFOSIT/NOINSTRUCTION/NOASCII/BYTE 
LOC? 200 

NEW 123456543 

AZPATCH-I-NUMTRUNCs rumber truncated 


NEW? EXIT 

4PATCH-I-NUMTRUNCs number truncated 
old? 000002003 an 

news 000002003 43 


e Set only the last length mode specified when you _ enter 
conflicting length modes on a single command line. 


6.2.3 Radix Modes 


The modes that specify the radix are OCTAL, DECIMAL, and HEXADECIMAL. 
They refer to the base by which PATCH translates the entry or display 
of numeric data and addresses. The following rules apply to the radix 
modes: 


@ Ignore the radix mode when the context modes are set 
e Display data according to the current length mode 


e Set only the last radix mode specified when you enter 
conflicting radix modes on a single command line 


You can also change the radix modes by specifying a radix operator 
(O° Dy" Ky" B) s A radix operator controls only the entry that it 
accompanies; it has no control over the radix in which PATCH displays 
a value. (See Section Te9ely "Radix Operator," for more 
information.) 
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6.2.4 Symbol Search Modes 
The symbol search modes are: 


SCOPE NOSCOPE 
GLOBALS NOGLOBALS 


Like the context modes, the symbol search modes’ serve as ON-OFF 
switches. These modes control how PATCH performs symbol translations. 


6.2.4.1 SCOPE-NOSCOPE Modes - The SCOPE-NOSCOPE modes control whether 
the contents of the scope setting are prefixed to a symbolic entry 
when PATCH tries to locate the numeric address represented by that the 
symbolic entry. Note that PATCH follows a certain procedure when 
performing symbol-to-value translations. This procedure is based on 
the current setting of the SCOPE-NOSCOPE and GLOBALS-NOGLOBALS modes. 
See Chapter 4 for the procedure PATCH uses to perform symbol-to-value 
translations. 


6.2.4.2 GLOBALS-NOGLOBALS Modes - The GLOBALS-NOGLOBALS modes, like 
the SCOPE-NOSCOPE modes, control whether the contents of the scope 
setting are prefixed to a symbolic entry when PATCH tries to locate 
the numeric address represented by the symbolic entry. Note that 
PATCH follows a certain procedure when performing symbol-to-value 
translations. This procedure is based on the current setting of the 
SCOPE-NOSCOPE and GLOBALS-NOGLOBALS modes. See Chapter 4 for the 
procedure PATCH uses to perform symbol-to-value translations. 


CHAPTER 7 


RULES OF SYNTAX 


This chapter provides information on the rules PATCH adheres to when 
processing commands. 


7.1 COMMAND PROMPTING 


All PATCH commands, except the EXAMINE command, issue a prompt’ when 
insufficient parameters accompany the command name. For example, the 
DEPOSIT command prompts for a location and the contents you are 
depositing in that location if you omit these parameters: 


PATCH: DEPOSIT 
LOC 1363 
NEW? O1 


Some commands require an equal sign (=). When you let PATCH prompt 
for omitted parameters in such commands, do not specify the equal 
sign. . 
Some commands repeatedly prompt for a given parameter when that 
parameter is omitted. In such cases, type the EXIT command to 
terminate the prompt. The SET MODE command typifies this rule: 


FATCH: SET MODE 
NEW: INSTRUCTION 
NEW: SYMBOLS 
NEW: NOGLOBALS 
NEW> EXIT 


The SET MODE command continues to prompt for mode values until you 
type EXIT to complete the command sequence. 


Note that you can enter only one parameter in response to a repetitive 
prompt. For example, typing: 


FATCH: SET MODE 
NEW: INSTRUCTIONy NOASCII» BYTE 


results in the following error message: 
“ZFATCH-W-SYNTAXs command syntax error at or near ‘rsNOASCIT +B’ 


The commands CHECK ECO and CHECK NOT ECO accept a single value or a 
Single range of values in response to the repetitive prompt. 
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7.2 CONTINUING COMMANDS OVER MULTIPLE LINES 


You can continue a command over multiple lines by typing a hyphen 
character (-) as the last nonblank, noncomment' character on the 
command line. For example: 


PATCH? DEPOSIT — 
~~ SBYTE- 

-~* 300 - 

ww = 34 


The > characters indicate continuation lines. 


When you continue commands over more than one line, you must. still 
Supply all the required syntax. In the above example, the equal sign 
(=) must be specified. 


7.3 ENTERING ASCII DATA STRINGS 


When you enter ASCII data strings to PATCH, they must be enclosed 
within matching quotation marks (") or apostrophes ('). By allowing 
either quotation marks or apostrophes to be string delimiters, you can 
include one or the other delimiter as part of the input string. For 
example, if you want to insert the ASCII text ‘'AL', you would type: 


PATCH? DEPOSIT/ASCII 500 = "’AL‘" 


You cannot delimit an ASCII data string with the same delimiter as the 
one you include as part of the string. For example, typing the 
following command results in an error: 


PATCH? DEPOSIT/ASCII 500 = ’’AL’’ 


When entering an ASCII data string, PATCH will truncate the string if 
it exceeds the length imposed on it by the current length mode 
setting, as shown below: 


PATCH? SET MODE ASCII»BYTE 

FATCH> DEPOSIT 600 = ’ABCIEFG’ 
ZPATCH-I-STGTRUNCs string truncated 
“ZPATCH-I-NUMTRUNC, number truncated 
old? 000006003 ~~ 

news 000006003 A’ 


PATCH truncates the string by discarding excessive characters from the 
right. 


Finally, to enter ASCII data strings, either specify the /ASCII mode 
qualifier or set ASCII mode. For more information on ASCII mode, see 
Section 6.2. 


7.4 ENTERING VAX-11 MACRO INSTRUCTIONS 


The rule for the use of quotation marks (") and apostrophes (') as 
described for entering ASCII data strings (Section 7.3) also applies 
for entering VAX-11 MACRO instructions. In brief, an instruction 
String entry must be delimited by quotation marks or apostrophes and 
not a combination of both, and the delimiter must not appear within 
the string. 
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In addition, to enter VAX-11 MACRO instructions, either specify the 
/INSTRUCTION mode qualifier or set the INSTRUCTION mode. For more 
information on INSTRUCTION mode, see Section 6.2. 


To enter operands with displacements, you must prefix the operand with 
B*, W*, or L*. For example: 


PATCH? DEPOSIT 500 = B"ACRO) 


7.5 ENTERING NUMERIC DATA 


When you enter numeric data _ to PATCH, the mode qualifiers 
/NOINSTRUCTION and /NOASCII must be specified or the NOINSTRUCTION and 
NOASCII modes must be set. In addition, do not enclose the data 
within matching quotation marks or apostrophes. 


You can, however, enter numeric data concurrently with instructions 
provided you are using the assembler directives listed below: 


~BYTE 
- WORD 
- LONG 


The following example illustrates such an insertion: 


PATCH? DEFOSIT/PATCH_AREA/ INSTRUCTION 
NEW? ‘TSTL R4’ 

NEW> ‘BEOL LBL3’ 

NEW> ‘“MOVL LBL2sRO’ 

NEW> ‘LBL1I’ RET’ 

NEW> /“LBL2? «LONG 190’ 

NEW> ‘LEL3? MOVL LBL2+4*R0’ 

NEW? ‘BRE LBL’ 


Precede any hexadecimal number starting with an alphabetic character 
(that is, A through F) with a0. For example, enter the numeric 
string FFA as follows: 


OFFA 


7.6 DELIMITING PARAMETER VALUES 


The equal sign (=) is used to Separate an address expression from a 
data entry or to separate a symbol name from a value. The commands 
that require the equal sign are DEFINE, DELETE, DEPOSIT, INSERT, 
REPLACE, and VERIFY. 


To separate parameter values in commands that can optionally take 
multiple parameters, use a comma. For example: 


PATCH? DEFOSIT/ASCIIT S08 = ‘DOG’ »s’CAT’» ‘BIRD’ 


7.7 ENTERING COMMENTS 


To insert comments, prefix them with the exclamation point (!) 
character. When PATCH reads an exclamation point, it ignores all 
following information on that line. The only restriction on entering 
comments is that a comment cannot appear on the same line as a command 
string that uses a continuation character (-). 


v=3 
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The following are examples of some valid comments: 


1. PATCH? REPLACE/INSTRUCTION 300 (!Rerlacinea instruction im loc 300 


OLD "PUSHAL L“11102457" with the new 
OLDS EXIT value 
NEW> "PUSHAL L™11100245" 'PUSHAL L71110245 
2. PATCH> DEPOSIT/ASCII- 
wu 1206 - 
ene = "CAR" tab 
~-* EXIT IThis comment describes the 


fentire DEPOSIT command 


7.8 TRUNCATING KEYWORDS 


To simplify the process of entering commands, you can abbreviate the 
following keywords: 


e Command names 

e Mode, alignment, and other qualifiers 

e Parameter values for the SET MODE command 
PATCH does not recognize the different categories of keywords. 
Therefore, any keyword abbreviation must be unique with respect to all 
other keywords. 
Some keywords can be truncated to nonunique abbreviations. These 


keyword abbreviations are listed below in Table 7-1: 


Table 7-1 
Nonunique Keyword Abbreviations 


DEPOSIT 
EXAMINE Command name 


Mode qualifier 
INSTRUCTION 


Appendix A lists all PATCH commands with their associated qualifiers 
and their abbreviated format. 











Abbreviation 


Command name 











7.9 SPECIAL OPERATORS FOR ARITHMETIC EXPRESSIONS 


This section describes the special operators that PATCH recognizes in 
arithmetic expressions, and gives examples of how to use these 
operators. Table 7-2 provides a brief description of each operator. 
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Table 7-2 
Special Operators for Arithmetic Expressions 


Addition operator Unary plus sign or addition 
operator in arithmetic 
expressions 


Subtraction operator Unary minus sign or 
subtraction operator in 
arithmetic expressions 


Multiplication operator Multiplication operator in 
arithmetic expressions 


Division operator Division operator in 


arithmetic expressions 


Shift operator Arithmetic shift operator 
Priority operators 1. Priority operators 


2. Bit field delimiters for 
the EVALUATE command 


Radix operator Radix operator for 
hexadecimal, decimal, octal, 
or binary notation 





7.9.1 Addition Operator (+) 


Use the addition operator (+) as a binary operator to add_ two 
arguments together. Use the addition operator as a unary operator to 
specify the existing value of the argument. Used in this context, the 
addition operator can be omitted and the same results will occur. 


The following examples show how to use the addition operator as a 
binary and unary operator: 


PATCH EVALUATE /HEXADECIMAL “R10 + “L143 
00000035 

PATCH? DEFINE X = ~1 

PATCH? EVALUATE +X 

OFFFFFFFF 

PATCH? EVALUATE X 

OFFFFFFFF 


The results are displayed in the current radix. 


7.9.2 Subtraction Operator (-) 


Use the subtraction operator (-) as a binary operator to subtract one 
argument from another. Use the subtraction operator as a unary 
operator to specify the negation of the argument. 
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The following examples show how to use the subtraction operator as a 
binary and unary operator: 


PATCH> EVALUATE /HEXADECIMAL “DS58 ~- “n14 
0000002C 

PATCH> DEFINE X = —-1 

PATCH> EVALUATE ~-X 

00000001 


The results are displayed in the current radix. 


7.9.3 Multiplication Operator (*) 


Use the multiplication operator (*) to multiply two arguments. For 
example: 


PATCH> EVALUATE 10 x 10 
00000100 


The result is displayed in the current radix. 


7.9.4 Division Operator (/) 


Use the division operator (/) to divide the first argument by _ the 
second argument. PATCH truncates the quotient to an integer value. 
For example: 


PATCH> EVALUATE “DS / “D3 
00000001 


The result is displayed in the current radix. 


Note that PATCH does not let you divide by 0. 


7.9.5 Arithmetic Shift Operator (@) 


Use the arithmetic shift operator (@) to shift the first argument’ the 
number of bit positions specified by the following value. A positive 
value means shift to the left and lose the contents of the sign bit. 
A negative value means shift to the right and propagate the contents 
of the sign bit in the vacated bit positions. 


The shift operation is arithmetic; no wraparound occurs as it does in 
a logical shift. 


The following example demonstrates the use of the arithmetic shift 
character: 


PATCH> EVALUATE SFCO @-2 
000017F0 
PATCH? EVALUATE “L100 @2 
00000190 


The results are displayed in the current radix. 
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7.9.6 Priority Operator (< >) 


Expressions are normally evaluated from left to right, except when the 
command contains angle brackets, or priority operators, (< >). Then, 
the expression contained within the priority operators is evaluated 


first. An expression can contain up to 16 levels of nested 
expressions. PATCH evaluates them from innermost to outermost. For 
example: 


PATCH? EVALUATE/DECIMAL <Sk*716-<S+89>>> 
3110 


7.9.7 Radix Operator (%) 

Use the radix operator to control PATCH's interpretation of numeric 
strings. The radix character affects only the entry that it 
accompanies; PATCH displays the results in the current radix. 


The radix operators for the VAX-11 MACRO language are: 


Operator Radix 
*O Octal radix 
“D Decimal radix 
“xX Hexadecimal radix 
“B Binary radix 


PATCH does not allow spaces between a radix character and a numeric 
String. 


The following example uses a radix character: 


PATCH? DEPOSIT/DECIMAL “X300 = 15 
olds 000007683 00000000 
news 000007683 00000015 


In the above example, the radix mode is set to decimal representation; 
however, the location to be modified is set to hexadecimal 
representation. The display is decimal. 


7.10 SPECIAL OPERATORS FOR ADDRESSING LOCATIONS 


This section describes the special operators that PATCH recognizes for 
locating addresses and gives examples of how to use these operators. 
Table 7-3 provides a brief description of each operator. 
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Table 7-3 
Special Operators for Addressing 


Current location 
operator 











Displays the location last 
specified; that is, the current 
location 


Previous location 
operator 


Displays the location that 
precedes the last location 
specified; (subtract, from the 
current location, the number of 
bytes indicated by the length 
mode) 

Range operator Range operator for the CHECK ECO, 
CHECK NOT ECO, EVALUATE, and 
EXAMINE commands 

Backslash operator Displays either the contents of 
the location specified in a 
branch instruction or the value 
stored in an address specified in 
the previous EXAMINE command 


7.10.1 Current Location Operator (.) 


Use the current location operator (.) to access the address specified 
most recently. This value remains the same until you reference a new 
address. The current location operator can be used in place of a 
symbolic or numeric address in any command that requests a location. 
For example: 


FATCH> EXAMINE/INSTRUCTION S00 
000005003 BBC RMS_DOC 
FATCH> DEPOSIT/INSTRUCTION . = ‘’BBCC RMS_DOC’ 


7.10.2 Previous Location Operator (*) 


Use the previous location operator (*) to access the address preceding 
the current address. The previous location operator can be used in 
Place of a symbolic or numeric address in any command that requests a 
location. Using this operator when INSTRUCTION mode is set produces 
unpredictable results. 


The following example demonstrates the use of the previous’ location 
operators: 


PATCH EXAMINE/ASCII/LONG S06 


000005063 “RATH’ 
PATCH> EXAMINE/ASCII/LONG * 
000005023 ‘VERA ‘ 


Note that PATCH decrements memory locations according to the current 
length mode. 
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7.10.3 Range Operator (:) 


Use the range operator (:) to specify a range of locations for the 
EXAMINE command or to specify a range of ECO levels in the CHECK ECO 
and CHECK NOT ECO commands. For example: 


PATCH EXAMINE .2205 
000002033 TSTL R4 
000002053 BNEQ FADSSTRT 
PATCH? CHECK ECO 9923103 


The range operator can also be used to separate bit field delimiters 
in the EVALUATE command. For example: 


PATCH? EVALUATE 700<825> 


See the EVALUATE command in Chapter 8 for a complete description of 
evaluating variable length bit fields. 


7.10.4 Backslash Operator (\) 


Use the backslash operator (\) with the EXAMINE/INSTRUCTION command to 
display the contents of a location specified in a branch instruction. 
For example: 


PATCH? EXAMINE/INSTRUCTION 750 

000007503 BRW 7515 

PATCH> EXAMINE/INSTRUCTION \ 

000075152 PUSHL L”“NAMENREGIN+1 29 L“NAME\BEGING23 


Used with the EXAMINE command, the backslash operator displays the 
value stored in an address that is displayed in response to the 
previous EXAMINE command. For example: 


PATCH> EXAMINE 100 
0000010023 00000500 
PATCH> EXAMINE \ 
000005003 00000002 


7.11 VAX-11 MACRO INSTRUCTIONS WITH THE SAME OPCODES 


IN VAX-11 MACRO, different instructions can generate the same opcode, 
For example, MOVAL and MOVAF both generate the hexadecimal opcode DE. 
PATCH, however, displays only one instruction for any of the opcodes 
that can be produced by multiple instructions. For example, if you 
use MOVAF in your source program, PATCH displays MOVAL. 


Table 7-4 lists the instructions that have the same opcodes, lists the 
instruction produced by PATCH, and lists the opcodes themselves, 
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Table 7-4 
Instructions Displayed by PATCH for 
VAX-11 MACRO Instructions with Equivalent Opcodes 


Instructions with Instruction Displayed 
Equivalent Opcodes by PATCH 


BGEQU 


BCS 
BLSSU 


BEQL 
BEQLU 


BNEQ 
BNEQU 


CLRD 
CLRG 
CLRQ 


CLRF 
CLRL 


CLRH 
CLRO 


MOVAD 
MOVAG 
MOVAQ 


MOVAF MOVAL 
MOVAL 


MOV AH MOVAO 
MOVAO 


PUSHAD PUSHAQ 
PUSHAG 
PUSHAQ 


PUSHAF PUSHAL 
PUSHAL 


PUSHAH PUSHAO 
PUSHAO 





CHAPTER 8 


PATCH COMMANDS 


This chapter lists and describes the PATCH commands in alphabetical 
order. For a summary description of the PATCH commands, see Appendix 
A. 


PATCH COMMANDS 


ALIGN 


Description 


Use ALIGN to allocate space for default patch area in image files 
that have not been patched previously or to advance the starting 
address of the current patch area to the first free byte aligned 
on the requested boundary (byte, word, longword, quadword, or 
page) and to equate a symbolic name to that address. Once you 
define the symbolic name, you can use it in place of the address 
it denotes. 


When you specify ALIGN, none of the patch area between the old 
patch area address and the aligned patch area address is 
cataloged by PATCH. You must keep a record of the disjointed 
patch area for it to be used. 


After an alignment has been made, the patch area string 
descriptor is updated to reflect the modifications. If the patch 
area is already aligned on the specified boundary, no update is 
performed. (See Section 5.3 for more information on patch area 
string descriptors.) 


You must enter one, and only one, alignment qualifier for each 
ALIGN command. 


Format 
ALIGN symbol-name 
Alignment Qualifiers Defaults 
/BYTE None. 
/WORD 
/LONG 
/QUAD 
/PAGE 
Prompts 
NAM> symbol-name 
Parameters 
symbol-name 
Specifies a 1- to 15-character symbol. It must start with an 
alphabetic character, and consist of alphanumeric characters, 
dollar signS ($), and/or underscores (_). 
If you specify a symbol name for an address that has_ been 


previously assigned a symbol name, the newest symbol name takes 
precedence. 
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Alignment Qualifiers 


Defines the symbol as the first free byte of the current patch 
area. If the current patch area has not been used previously, 
PATCH allocates the first block of default patch area. 


Advances the starting address of the current patch area to the 
first free word boundary. 


Advances the starting address of the current patch area to the 
first free longword boundary. 


Advances the starting address of the current patch area to the 
first free quadword boundary. 


Advances the starting address of the current patch area to the 
first free page boundary. 


Examples 


1. PATCH> ALIGN/QUAD MOD_1 


Old ratch area size; QOQOO0O1LES 
old ratch area address? 00000810 
new ratch area size’ OO0001E0 
new Patch grea address? 00000820 


symbol "MOD.1" defined as 00000820 


The ALIGN command requests that the patch area starting address 
be advanced to the first free quadword boundary in the current 
patch area and that the symbol MOD 1 be equated with that 
address. The display shows the old and new patch area status. 


2. FATCH® ALIGN/BYTE FAT REA 


old ratch ares size? 00000000 
old Fatch area address? 00000000 
new ratch area size? 00000200 
new ratch srea address? 00001800 


symbol "FATAREAS defined aes 00001800 


This ALIGN command allocates the first block for the default 
patch area and assigns’ the symbol PATAREA to its new starting 
address. 
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CANCEL MODE 


Description 


Use the CANCEL MODE to control the syntax of commands you enter 
and the values PATCH displays. CANCEL MODE cancels the current 
mode settings and reinstates the initial default mode_ settings. 
The initial default mode settings are: NOINSTRUCTION, NOASCII, 
SYMBOLS, HEXADECIMAL, LONG, NOGLOBALS, and SCOPE. 


Format 
CANCEL MODE 
Prompts 
None. 
Parameters 
None. 
Examples 


1. PATCH> SHOW MODE 
modes: nosymbols, instructions asciis scorer dlobalsr decimals word 
PATCH> CANCEL MODE ; 
PATCH> SHOW MODE 
modes! symbols» noinstructions noasciis scorer mosglobalss hexadecimal longs 


The first SHOW MODE command displays the current mode status. 
The CANCEL MODE command requests that the initial default mode 
settings be reinstated. The second SHOW MODE command confirms 
that the initial default settings have been re-established. 
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CANCEL MODULE 


Description 


Use CANCEL MODULE to remove local symbol information from PATCH's 
symbol table; this command does not remove global symbols, patch 
area symbols, universal symbols, or symbols you defined with’ the 
DEFINE command. Once the module's local symbols have been 
removed, they cannot be used to reference locations. 


To remove all local symbol information from the symbol table, 
specify the /ALL qualifier. 


If the scope is the name of the module that you specify with’ the 
CANCEL MODULE command, the contents of the scope is reset to the 
empty string (<null>). 

Format 


CANCEL MODULE module-name [,...] 


Other Qualifiers Defaults 
/ALL None. 
Prompts 


NAM> module-name 
Parameters 
module-name 


Specifies the name of one or more modules whose local symbols are 
to be removed from the symbol table. 


Do not specify a module name if you include the /ALL qualifier. 


Other Qualifiers 


/ALL 
Removes all local symbol information from the symbol table. 
Examples 
1. PATCH? SHOW MODULE 
module name symbols size 
LOVAT Yes 180. 
total modules’ 1. 
remaining size?’ EEAA. 
PATCH: CANCEL MODULE 
NAM: LOVAT 
NAM? EXIT 


The SHOW MODULE command indicates that the _ local symbols 
contained in the module named LOVAT are entered in the symbol 
table. The CANCEL MODULE command purges the symbol table of the 
local symbols contained in LOVAT. 
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2. PATCH CANCEL MODULE/ALL 


This CANCEL MODULE command removes all local symbol names entered 
in the symbol table. 


3. FATCHSSET SCOFE CIRCLE 


+ 


FATCH> CANCEL MODULE CIRCLE 
FATCH> SHOW SCOPE 
SCOFES <rmu1l1l> 


The SET SCOPE command establishes the module named CIRCLE as'- the 
current scope setting. Later, the CANCEL MODULE command removes 
all local symbols in CIRCLE from the symbol table and, at _ the 
same time, sets the scope to the empty string (<null>). The SHOW 
SCOPE command confirms the new scope setting. 
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CANCEL PATCH_AREA 


Description 


Use CANCEL PATCH AREA to reset the current patch area from a 
user-defined patch area to the default patch area. Any patch 
area needed thereafter will be taken from the default patch area 
until the next SET PATCH _AREA command is issued. 


The CANCEL PATCH AREA command is used primarily when you have 
issued the SET PATCH_AREA command to establish a user-defined 
patch area as the current patch area. After you have’ inserted 
the necessary patch information into that area, type CANCEL 
PATCH AREA to resume use of the default patch area. 


You must specify the CANCEL PATCH AREA command if you _ have 
defined, and are using, a user-defined patch area that is too 
small to store the patches you want to insert. Failing to use 
the CANCEL PATCH AREA command causes PATCH to return an error 
message indicating that it cannot insert the patch, from the 
failing command, into the patch area. 


Format 
CANCEL PATCH AREA 
Prompts 
None. 
Parameters 
Norre. 
Examples 


1. PATCH? SET FATCH.AREA AREAL 


¢ 
+ 
¢ 


PATCH>CANCEL PATCH AREA 


The SET PATCH_AREA command establishes the user-defined patch 
area AREAl as the current patch area. After depositing the 
necessary data into AREA1, the CANCEL PATCH _AREA command is 
issued to resume use of the default patch area. 
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CANCEL SCOPE 


Description 


Use CANCEL SCOPE to cancel the current symbolic scope and revert 
to an empty string (<null>). 


Format 


CANCEL SCOPE 


Prompts 


None. 


Parameters 


None. 


Examples 


1. PATCH> SHOW SCOPE 
SCOPE? MOD1 
PATCH> CANCEL SCOPE 
PATCH> SHOW SCOPE 
score’: <null> 


The first SHOW SCOPE command indicates that the scope is set to 
the module named MOD1. The CANCEL SCOPE command cancels the 
scope setting and reverts to the empty string (<null>). The 
second SHOW SCOPE command confirms that.the contents of the scope 
is an empty string. 
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CHECK ECO 


Description 


Use CHECK ECO to check that one or more ECO levels have been set, 
and therefore, that the patches represented by these ECO levels 
have been applied to the image file. Remember that an ECO level 
is not set until the patch that it represents is terminated by 
the UPDATE command. For example, if you define an ECO level with 
the SET ECO command, then immediately check to see whether the 
ECO level is set, PATCH returns an error message indicating that 
the ECO level is not set. 


When you issue the CHECK ECO command, you do not have to list all 
the ECO levels that have been set for a particular image file. 
However, specifying one or more ECO levels that have not been set 
will produce an error message. 

Format 
CHECK ECO eco-level [:eco-level] [,...] 

Prompts 

ECO> eco-level 

Parameters 


eco-level 


Indicates one or more ECO levels that have been set. ECO levels 
can be entered in: 


e Comma-separated lists 
e Colon-separated ranges 
Both comma-separated lists and colon-separated ranges can _ be 
specified on the initial command line. However, only one ECO 
level or one range of ECO levels can be entered in response to an 
ECO level prompt (ECO>). 
Examples 


1. PATCH> CHECK ECO 338914916 


This command checks that the patches associated with ECO levels 
3, 4, 5, 6, 7, 8, 14, and 16 have been applied to the image file. 


2. PATCH> CHECK ECO 12 
%PATCH~-E-ECONOTSET» eco level 12 not set in DB23 CHARINGTONIBIND..NOW.EXE#4 


The CHECK ECO command checks that the patch associated with ECO 
level 12 has been applied to the image file. The display 
indicates that ECO level 12 has not been set and that the patch 
it represents has not been applied to the image file BIND.EXE. 
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CHECK NOT ECO 


Description 


Use CHECK NOT ECO to check that one or more ECO levels 
available for use in a particular image file. 


The CHECK NOT ECO command is the negation of the CHECK 


are 


ECO 


command. It too can be used to confirm that a particular patch 
has been applied to an image file. Typically, however, the CHECK 
NOT ECO command is used to confirm the ECO levels that are 


available for use in the current image file. 
Format 

CHECK NOT ECO eco-level [:eco-level] [,...] 
Prompts 
ECO> eco-level 
Parameters 


eco-level 


Indicates the ECO levels that are not Set. ECO levels can 


entered in: 
e Comma-separated lists 


e Colon-separated ranges 


Both comma-Separated lists and colon-separated ranges’ can 


be 


be 


entered on the initial command. However, only one ECO level or 


one range of ECO levels can be entered in response to an 


level prompt (ECO>). 


Examples 
1. PATCH> CHECK NOT ECO 426710 


This command confirms that the ECO levels 4, 5, 6, and 10 
available for use. 


2. PATCH> CHECK NOT ECO 
ECO> 17 
ECO> EXIT 


ECO 


are 


“PATCH-E-ECOSET» eco level 17 already set in DBIS CREAVERIMYFILE.EXE#7 


In response to the CHECK NOT ECO command, PATCH indicates 


that 


ECO level 17 has already been used in the image file MYFILE.EXE. 
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CREATE 


Description 


Use CREATE to create a command procedure that contains all PATCH 
commands successfully executed after the CREATE command. 


Command procedures facilitate patching multiple copies of the 
same image file. There are two ways to create command 
procedures. One way is to specify the CREATE command when you 
invoke PATCH. All subsequent, successful commands are applied to 
the image file and recorded in the command procedure. A second 
way is to use a text editor. This method is discussed in Section 
B¢Sis 2s 


When you use CREATE to create a command procedure, PATCH 
automatically inserts, as the first entry in the command 
procedure, the name of the image file that will incorporate the 
patches. All symbolic names are converted to absolute values, 
and all command names and qualifiers are truncated to their 
Shorthand notation. 


You can issue only one CREATE command per PATCH” session. To 
create another command procedure, close the input image file and 
then reopen it. 


To process the patches contained in the command procedure, issue 
the following DCL command: 


$ PATCH @file-spec 


In the above command line, the file-spec represents the 
specification of the command procedure containing the patches. 


Chapter 2 discusses the different techniques for creating command 
procedures; Chapter 3 discusses how to submit command procedures 
for PATCH processing. 


Format 


CREATE {file-spec] 


Prompts 


None. 


Parameters 


file- 


spec 


Represents the specification of the command. procedure. The 
syntax is: 


device: [directory] filename. filetype;version 
You can omit all or some of the fields in the command _ procedure 


file specification. PATCH uses the default values listed below 
for omitted fields. 
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Field Default Value 
device: [directory] The process's current default device and 
directory 
filename The name of input image file 
filetype ~COM 
version 1 greater than the highest 


command procedure of the same name 


Note that if you store a command procedure in a directory other 
than the one that contains the input image file to which the 
command procedure is applied, you must set your default to the 
directory that contains the input image file before you process 
the command procedure. 


Examples 
1. $$ FATCH AVERAGE 
FATCH VERSION 2.0 15 MAR 80 


PATCH? CREATE FAT2 
PATCH? SET ECO 1. 
PATCH> SET MODE NOSYMBOLS 
FATCH> EXAMINE 600 


000006003 12345678 

PATCH? DELETE 600 = 12345678 
olds 000006003 12345678 
news 000006003 00000000 


PATCH? UPDATE 

ZPATCH-I-WRIFIL» urdating image file DBA2} CRRADLEY IAVERAGE.EXE $6 
PATCH EXIT 

$ SET DEFAULT CNIMRODI 

$ SHOW DEFAULT 

DBAZS CNIMROLY 

$ FATCH @CBRADLEYIPAT2 


In the above command procedure, PATCH is invoked to patch the 
image AVERAGE.EXE in the DBA2:[BRADLEY] directory. The CREATE 
command creates the command procedure PAT2.COM in which all 
successful commands are stored. 


After the PATCH session ends, the default directory is set to 
DBA2: [NIMROD] and the patches in the command procedure PAT2.COM 
are applied to the image file [NIMROD] AVERAGE.EXE. 
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DEFINE 


Description 


Use DEFINE to equate a symbolic name to a specific value and 
place the symbolic name in the symbol table. Once the assignment 
has been performed, you can specify the the symbolic name _ in 
place of the value it denotes for the duration of the PATCH 
session. At the end of the PATCH: session, these user-defined 
symbols are deleted from the symbol table. 


When you use the DEFINE command to create symbolic names, PATCH 
always searches the symbol table for these symbolic names first 
when it translates a symbol into a value. 
More than one symbolic name can be assigned to a_ single value. 
Each symbolic name is recorded in the symbol table and can 
subsequently be used to reference the value it denotes. 
You can redefine a symbolic name to represent a new value. Then, 
when you specify the symbolic name, the most recent value that 
the symbol denotes is displayed. 
Two restrictions apply to the use of the DEFINE command: 
e You can not equate a symbolic name to a pathname 
e You cannot specify the /INSTRUCTION or /ASCII mode 
qualifiers, nor can you set’ the INSTRUCTION or ASCII 
modes, when equating a symbol name to a value 
Format 
DEFINE symbol-name = value [,synibol-name = value,...] 


Prompts 


NAM> symbol-name 
VAL> value 


Note that if you enter the symbol name on the initial command line, 
you must also enter the value on that line. 


Parameters 
symbol-name 


Specifies a 1- to 15-character user-defined symbol to be 
associated with the specified value. The symbol name must start 
with an alphabetic character, and can consist of alphanumeric 
characters, dollar signs ($), and/or underscores ( ). (PATCH 
does not distinguish between uppercase and lowercase letters; 
that is, the value ABC is equivalent to the value abc.) 


The symbol name cannot be a pathname. 
value 


Specifies a numeric address or symbolic expression that is to. be 
assigned the specified symbolic name. 
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Examples 


1. PATCH? DEFINE SWEDISH = CAR\VOLVO+144 
Symbol "SWEDISH" defined as CARN\VOLVO+144 
PATCH? EXAMINE SWEDISH 


The DEFINE command creates a symbolic name for the value 
CAR\VOLVO+144. A subsequent EXAMINE command requests to see the 
contents of CAR\VOLVO+144 using the symbol name SWEDISH. 


2. PATCH? DEFINE 


NAM> SECOND..CHOICE 
VAL> 406 


NAM> EXIT 
symbol "SECOND CHOICE" redefined from 408 to 406 


The DEFINE command reassigns the symbol SECOND CHOICE from _ the 
value 408 to the value 406. The DEFINE command response shows 
the reassignment. 


a 
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DELETE 


Description 
Use DELETE to delete an instruction or piece of data from 
location or from several consecutive locations in terms of 
current mode settings. 


When you use the DELETE command to delete instructions, 


one 


the 


the 


instructions are replaced with NOP instructions. When you use 


the DELETE command to delete ASCII and numeric data, the data 
replaced with zeros. 


Format 


DELETE location = current-contents [,...] 


Mode Qualifiers Defaults 

/BYTE 

/WORD / LONG 

/ LONG 

/OCTAL 

/DECIMAL /HEXADECIMAL 

/HEXADECIMAL 

/(NO] ASCII /NOASCII 

/{NO] INSTRUCTION /NOINSTRUCTION 

/ (NO] SYMBOLS / SYMBOLS 

/ [NO] GLOBALS /NOGLOBALS 

/ [NO] SCOPE / SCOPE 
Prompts 


LOC> location 
OLD> current-contents 


Parameters 
location 


Specifies either (1) a single location whose contents are to 


is 


be 


deleted or (2) the starting address of a sequence of locations 


whose contents are to be deleted. 


current-contents 


Specifies one or more data entries or instructions to be deleted. 
The data or instructions you specify must be the actual contents. 


Do not specify conflicting data types within a single DELETE 


command. 
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Mode Qualifiers 


/BYTE 
/WORD 
/ LONG 


Determine whether data is deleted in byte, word, or _  longword 
lengths. The length mode qualifiers affect only ASCII and 
numeric data. When you specify an instruction, the DELETE 
command ignores the current length setting and deletes the entire 
instruction. 


The initial default setting is /LONG. 


/OCTAL 
/DECIMAL 
/HEXADECIMAL 


Determine the radix in which virtual addresses and numeric data 
are interpreted and displayed. The radix mode qualifiers do not 
affect symbolic addresses and instructions, or ASCII data. 


The initial default setting is /HEXADECIMAL. 


/ASCII 
/NOASCII 


Control whether the data to be deleted is interpreted and 
displayed as ASCII data. 


When you specify /ASCII, enclose the data within matching 
quotation marks or apostrophes. The current radix setting has no 
affect on the ASCII data being deleted; however, the DELETE 
command truncates the data if it exceeds the length imposed on it 
by the current length mode. 


The initial default setting is /NOASCII. 


/ INSTRUCTION 
/NOINSTRUCTION 


Control whether the data to be deleted is interpreted and 
displayed as VAX-11 MACRO instructions. 


When you specify /INSTRUCTION, enclose the instruction within 
matching quotation marks or apostrophes. Neither the current 


radix setting nor the current length’ setting affect the 
instruction being deleted. 


The initial default setting is /NOINSTRUCTION 


/SYMBOLS 
/NOSYMBOLS 


Control whether locations are displayed as pathnames or’ symbols, 
rather than as numeric addresses. 


The initial default setting is /SYMBOLS. 
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/GLOBALS 
/NOGLOBALS 


Control whether the symbolic entry (exactly as entered) is used 
as the first or last pathname in a search. 


The initial default setting is /NOGLOBALS. 


/SCOPE 
/NOSCOPE 


Control whether scope's contribution to a pathname is used _ to 
find the location specified. 


The initial default setting is /SCOPE. 
Examples 


1. PATCH? DELETE/INSTRUCTION 2112 = ‘CMPB (RO)»s (RS) ’ 
old? 000021123 CMPB (RO)»s(RS) 
news 000021123 NOP 
news 000021133 NOP 
news 000021143 NOF 


The DELETE command replaces the instruction CMPB (RO),(R5) with 
NOP instructions. 


2. PATCH> DELETE/SYMBOLS 
LOC® 7A6 
OLD OE6ADNDES9 
OLDS EXIT 
old? OTS$LINKAGENOTSS$LINKAGE+7C OE GAINES? 
news OTS$LINKAGENOTSS$LINKAGE+7C 00000000 


The DELETE command deletes the contents of location 7A6. Because 
/SYMBOLS is specified, location 7A6 is reported symbolically. 
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DEPOSIT 


Description 


Use DEPOSIT to deposit new data or instructions into one or more 
consecutive locations. 


Depositing Data or Instructions: The DEPOSIT command lets you 
replace the contents of a location or of several consecutive 
locations in terms of the current mode settings. The DEPOSIT 
command does not’ request verification of the current contents 
before replacing the contents with new data or instructions (that 
is, this command assumes that you know what you are doing). In 
cases when you want to confirm that data or instructions’ that 
will be overwritten, use the REPLACE command. 


When you are adding instructions to an image file, it is easier 
to use the INSERT command. This command performs automatic 
branching to and from the patch area. 


Depositing Data or Instructions into Patch Area: When you append 
the /PATCH AREA qualifier to the DEPOSIT command, the data or 
instructions specified are inserted into the current patch area. 
The location you supply must be the first free byte in patch 
area. To determine the first free byte in patch area, issue _ the 
SHOW PATCH_AREA command or the ALIGN/BYTE command. After you 
deposit the data, PATCH updates the patch area string descriptor 
to reflect the modifications. 


Unlike the INSERT and REPLACE commands, the DEPOSIT/PATCH_AREA 
command requires that you insert the branch instructions into the 
appropriate locations to maintain the logical flow of program 
execution to and from the patch area. 
See Chapter 5 for more information on uSing patch area. 

Format 


DEPOSIT location = new-contents [,...] 


Mode Qualifiers Defaults 
/BYTE 

/WORD / LONG 

/ LONG 

/OCTAL 

/DECIMAL /HEXADECIMAL 
/HEXADECIMAL 

/(NO] ASCII /NOASCII 
/(NO] INSTRUCTION /NOINSTRUCTION 
/ [NO] SYMBOLS /SYMBOLS 

/ [NO] GLOBALS /NOGLOBALS 

/ [NO] SCOPE /SCOPE 


Other Qualifiers 


/PATCH_AREA 
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Prompts 


LOC> location 
NEW> new-contents 


Parameters 


location 


Specifies either (1) a single location whose contents are to be 
overwritten or (2) the starting address of a sequence of 
locations whose contents are to be overwritten. 


new-contents 


Specifies one or more data entries or instructions to. be 
inserted. Do not enter conflicting data types with a single 
DEPOSIT command. 


Mode Qualifiers 


/BYTE 
/WORD 
/ LONG 


Determine whether data is deposited in byte, word, or longword 
lengths. The length mode qualifiers affect only ASCII and 
numeric data. When you specify an instruction, the DEPOSIT 
command ignores the current length mode and deposits the entire 
instruction. 


The initial default setting is /LONG. 


/OCTAL 
/DECIMAL 
/HEXADECIMAL 


Determine the radix in which virtual addresses and numeric data 
are interpreted and displayed. The radix mode qualifiers do not 
affect symbolic addresses and instructions, or ASCII data. The 
initial default setting is /HEXADECIMAL. 


/ASCII 
/NOASCII 


Control whether the data to be deposited is interpreted and 
displayed as ASCII data. 


When you specify /ASCII, enclose the data within matching 
quotation marks or apostrophes. The current radix setting has no 
affect on the ASCII data being deposited; however, the DEPOSIT 
“command truncates the data if it exceeds the length imposed on it 
by the current length mode. 


The initial default setting is /NOASCII. 
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/ INSTRUCTION 
/NOINSTRUCTION 


Control whether the data to be deposited is interpreted and 


displayed as VAX-11 MACRO instructions 


When you specify /INSTRUCTION, enclose the instruction within 
matching quotation marks or apostrophes. Neither the current 
radix setting nor the current length setting affects the 


instruction being deposited. 
The initial default setting is /NOINSTRUCTION. 


/ SYMBOLS 
/NOSYMBOLS 


Control whether locations are displayed as pathnames or 
rather than as numeric addresses. 


The initial default setting is /SYMBOLS. 


/GLOBALS 
/NOGLOBALS 


Control whether the symbolic entry (exactly as entered) 
as the first or last pathname in a search. 


The initial default setting is /NOGLOBALS. 


/SCOPE 
/NOSCOPE 


Control whether scope's contribution to a pathname is 
find the location specified. 


The initial default setting is /SCOPE. 
Other Qualifiers 
/PATCH_AREA 


Signals PATCH to deposit the data or instructions 
current patch area, starting at the specified location. 


Examples 
1. PATCH> DEFPOSIT/ASCII/BYTE 1111 = ‘A’ 


old? 000011113 ‘BR’ 
news 000011113 ‘A’ 


The DEPOSIT command requests that a byte of ASCII 


symbols, 


is used 


used to 


into the 


data he 


deposited in location 1111. The DEPOSIT display indicates that 
the data was successfully deposited and that the old contents was 


B. 
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2. FATCH> DEFOSIT/INSTRUCTION 
LOC> 413 
NEW> “CMFW (R1)» R6’ 
NEW? EXIT 
olds 000004133 CMFPW CRG)» R1 
news 000004133 CMFW (CR1Dd» RS 


The DEPOSIT command deposits an instruction into location 413. 
The /INSTRUCTION qualifier is specified to indicate that an 
instruction is being deposited. The DEPOSIT display indicates 
that the instruction was successfully deposited. 


3. FATCH> SET PFATCH.AREA NEW WFPATCH 
PATCH> ALIGN/BYTE 


Old ratch grea size 0000018C 
old ratch area address? 000004A8 
new ratch area size? 0000018C 
new ratch area address? 000004A8 


symbol "PATIL" defined as? 000004A8 
FATCH? DEFOSIT/FATCH.AREA/ASCIT 
LOC? FATI 

NEW? ‘RUN’ 

NEW: ‘SKIF’ 

NEW: EXIT 

old? FATIt = * 

old? 000004AC3 

news FATLE “RUN? 

news O00004AC? “SKIP 


The SET PATCH AREA command establishes the user-defined patch 
area named NEW PATCH as the current patch area. The ALIGN/BYTE 
command realigns the starting address of NEW PATCH on the first 
available byte address and defines the symbol PATI to that 
address. The DEPOSIT/PATCH AREA command is then issued to 
deposit into NEW PATCH at PAT] the ASCII data RUN and SKIP. 
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EVALUATE 


Description 
Use EVALUATE to evaluate one of the following: 
e Arithmetic expressions 
e Values 
e Variable-length bit fields 


Evaluating Arithmetic Expressions: Use the EVALUATE command to 
perform binary and unary arithmetic operations. (These 
operations are discussed in Section 7.8.) 


The EVALUATE command interprets expressions and displays’ results 
in the current length and radix modes. ‘5 
Evaluating Values: Use the EVALUATE command to determine the 
value associated with a symbol or pathname. The values are 
displayed in terms of the current length and radix mode setting. 


Evaluating Variable-Length Bit Fields: Use the EVALUATE command 
to display the current contents of a specific bit field ina 
value. The syntax for this command is: 


PATCH> EVALUATE value <high-bit:low-bit> 


The bit position delimiters (high-bit and low-bit) are specified 
as decimal integers. 


Bit positions range from 0 (least significant bit) to 31 (most 
Significant bit). PATCH extracts the contents of the bit 
positions and reports the contents in longword representation and 
in terms of the current radix setting. The current length mode 
is ignored. Note that ASCII mode and INSTRUCTION mode cannot be 
set when you evaluate selected bit positions. 


Format 


EVALUATE expression [,...] 


Mode Qualifiers Defaults 
/BYTE 

/WORD / LONG 

/ LONG 

/OCTAL 

/DECIMAL /HEXADECIMAL 
/HEXADECIMAL 

/(NO] ASCII /NOASCII 

/ (NO] INSTRUCTION /NOINSTRUCTION 
/ [NO] GLOBALS /NOGLOBALS 

/ [NO] SCOPE /SCOPE 
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Prompts 

EXP> expression 
Parameters 
expression 


Indicates an arithmetic expression, a value and corresponding bit 
field, or a literal value that is to be evaluated in terms of the 
current mode settings. As explained above, when you evaluate a 
selected bit field in a value, the format of the expression is: 


value <high-bit:low-bit> 
Mode Qualifiers 
/BYTE 


/WORD 
/ LONG 


Determine whether data is evaluated in byte, word, or longword 
lengths. The length mode qualifiers affect only the evaluation 
of arithmetic expressions; they have no control over evaluating 
bit fields. 


The initial default setting is /LONG. 
/OCTAL 


/DECIMAL 
/HEXADECIMAL 


Determine the radix in which data is interpreted and displayed. 
The radix mode qualifiers affect the evaluation of arithmetic 
expressions and of bit fields for specific values. 


The initial default setting is /HEXADECIMAL. 


/ASCII 
/NOASCII 


Control whether the data is interpreted as ASCII data. The 
/ASCII mode qualifier or the ASCII mode cannot be set when 
evaluating variable length bit fields. 

The initial default setting is /NOASCII. 


/ INSTRUCTION 
/NOINSTRUCTION 


Control whether data is interpreted as VAX-11l1 MACRO instructions. 
The /INSTRUCTION mode qualifier or the INSTRUCTION mode cannot be 
set when evaluating variable-length bit fields. 
The initial default setting is /NOINSTRUCTION. 


/GLOBALS 
/NOGLOBALS 


Control whether the symbolic entry (exactly as entered) is used 
as the first or last pathname in a search. 


The initial default setting is /NOGLOBALS. 


/SCOPE 
/NOSCOPE 


Control whether scope's contribution to a 


PATCH COMMANDS 


pathname is used to 


find the location specified. 


The intitial default setting is /SCOPE. 


Examples 


PATCH> 
12423 


l. 


This command performs the requested 


values are 


2. PATCH> 
PATCH> 


3518 


EVALUATE 


The EVALUATE command performs the specified arithmetic 


according to the 
decimal 65 by octal 


EVALUATE/DECIMAL 101 * 123 


arithmetic operation. The 


interpreted and displayed in decimal representation. 


SET MODE DECIMAL 
“X200 + < 


“N6S / “O12 > 


operation 
rules of precedence. PATCH first divides 
12, and then adds the quotient to hexadecimal 


200. The result is displayed in decimal representation. 
3. PATCH> EVALUATE “070 <5S23> 
00000007 


This command calculates the specified bit field value for the 
octal number 70. The result is displayed in the current radix 
setting (in this case, hexadecimal). 


PATCH> EVALUATE FDRSPETE 
00000600 


4. 


The EVALUATE command determines that the value assigned to the 
symbol FDRSPETE is 800. The result is displayed in the current 
radix setting (in this case, decimal). 
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EXAMINE 


Description 


Use EXAMINE to display the contents of the specified locations in 
terms of the current mode settings. 


You can also use the EXAMINE command to examine the contents of a 
branch instruction or the contents of an address displayed in 
response to the previous EXAMINE command. To do so, you use the 
backslash operator (\), which is fully described in Section 
7.10.4. 


Format 


EXAMINE location [:location] [,...] 


Mode Qualifiers Defaults 
/BYTE 
/WORD / LONG 
/ LONG 
/OCTAL 
/DECIMAL /HEXADECIMAL 
/HEXADECIMAL 
/{NO] ASCII /NOASCII 
/ (NO] INSTRUCTION /NOINSTRUCTION 
/ [NO] SYMBOLS /SYMBOLS 
/ [NO] GLOBALS /NOGLOBALS 
/ [NO] SCOPE /SCOPE 
Prompts 
None. 
Parameters 
location 


Specifies one or more locations whose contents are to be 
displayed. Multiple locations can be specified in a 
comma-separated list or colon-separated range. Both 
comma-Separated lists and colon-Separated ranges can be specified 
on a Single command line. 


The location parameter can also be represented by the backslash 
operator (\). This operator is used to observe the contents of 
the location displayed in the previous EXAMINE command. 


If you do not supply a location, the contents of the next 
sequential location will be displayed. 
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Mode Qualifiers 

/BYTE 

/WORD 

/LONG 
Determine whether data is displayed in byte, word, or longword 
lengths. The length mode qualifiers affect only ASCII and 
numeric data. When you specify an instruction, the EXAMINE 
command ignores the current length setting and displays the 
entires instruction. 
The initial default setting is /LONG. 

/OCTAL 


/ DECIMAL 
/HEXADECIMAL 


Determine the radix in which virtual addresses are interpreted 
and numeric data is displayed. The radix mode qualifiers do not 
affect symbolic addresses, symbolic instructions, or ASCII data. 


The initial default setting is /HEXADECIMAL. 


/ASCII 
/NOASCII 


Control whether data is displayed as ASCII data. 

When you specify /ASCII, the EXAMINE command truncates the data 
if it exceeds the limit imposed on it by the current length 
setting. 


The initial default setting is /NOASCII. 


/ INSTRUCTION 
/NOINSTRUCTION 


Control whether data is displayed as VAX-11 MACRO instructions. 
When you specify /INSTRUCTION, the EXAMINE command ignores’- both 
the current radix setting and the current length setting when 
displaying an instruction. 


The initial default setting is /NOINSTRUCTION. 


/ SYMBOLS 
/NOSYMBOLS 


Control whether locations are displayed as pathnames or symbols, 
rather than numeric addresses. 


The initial default setting is /SYMBOLS. 


/GLOBALS 
/NOGLOBALS 


Control whether the symbolic entry (exactly as entered) is used 
as the first or last pathname in a search. 


The initial default setting is /NOGLOBALS. 
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/SCOPE 
/NOSCOPE 


Control whether scope's contribution to a pathname is used _ to 
find the location specified. 


The initial default setting is /SCOPE. 


Examples 


1. PATCH> EXAMINE/INSTRUCTION/NOSYMBOLS 4600 


000006003 BNEQ 4634 
PATCH> EXAMINE/INSTRUCTION/NOSYMEOLS \ 
000006343 TSTL R4 


The response to the first EXAMINE command indicates that memory 
location 600 contains a branch instruction to location 634. 
Because the backslash character (\) is specified in the second 
EXAMINE command, the contents of location 634 are displayed. The 
/NOSYMBOLS qualifier requests that the locations be displayed by 
virtual addresses. 


2. PATCH? EXAMINE/ASCII 6503. 


000006503 “FE. .% 
000006543 of oe 
000006583 ‘FO ” 
0000065C3 “FUM ’ 


THE EXAMINE command requests a display in ASCII of all the data 
between location 650 and the current location (represented by the 
dot character). 


3. PATCH> SET MODE SCOPFE*sSYMBOLS 
PATCH> SET SCOPE NEGATION 


* 
o 


PATCH> SET MODE NOSCOFE 


° 


PATCH> EXAMINE/INSTRUCTION/SCOFE RO.CODE 
NEGATION/RO.CODE3 PUSHL L”NEGATION/RW.DATA+14 


In the above sequence of commands,-the modes SCOPE and SYMBOLS 
are set and the scope is established as the module named 
NEGATION. After PATCH performs a series of commands, the 
SCOPE-NOSCOPE mode is turned off, although the scope is still set 
to NEGATION. 


Still later, the EXAMINE command is’ specified to request’ the 
display of the instruction in location RO CODE. The /SCOPE 
qualifier requests that the scope be prefixed to RO CODE and that 
the symbol table be searched for a value that matches that entry. 
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4. PATCH? EXAMINE/ INSTRUCTION ’ 
000006003 BNEQ 634 
PATCH? EXAMINE/INSTRUCTION 
000006023 BRW LPLIST 
PATCH> EXAMINE/INSTRUCTION \ 
LPLIST3 MOVL R3rR4 


The first EXAMINE command requests that the contents of the 
current location (represent by the dot character) be displayed as 
a VAX-11 MACRO instruction. The second EXAMINE command requests 
that the next sequential location be displayed as a VAX-11 MACRO 
instruction. The third EXAMINE command requests’ that the 
contents of the destination of the previous branch instruction 
(BRW) be displayed. 
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EXIT 


Description 


Use EXIT to terminate a repetitive prompt such as NEW>, OLD>, 


ECO>, or to terminate a PATCH session and pass control back to 


the command interpreter. You can also specify CTRL/Z 


terminate a PATCH session. Issue CTRL/Z in response to the PATCH 


prompt (PATCH>). 


Do not type EXIT in response to the value prompt (VAL>) for 


DEFINE command. For this command, only the name prompt (NAM>) 


recognizes the EXIT command. 
Format 
EXIT 
Prompts 
None. 
Parameters 
None. 
Examples 
1. FATCHS SET MOTE 
NEWS INSTRUCTION 
NEW? NOSYMEOLS 
NEW> NOSCOFE 


NEW? EXIT 
FATCH> 


The SET MODE command continuously prompts for new mode settings 


until you enter the EXIT command. 


2. PATCH EXIT 
$ 


When you specify the EXIT command in response to a PATCH prompt 
(PATCH>), the PATCH session is terminated and control is passed 
back to the command interpreter. The dollar sign ($) indicates 


that you are no longer in PATCH. 


3. PATCH DEFINE 
NAM? TEST1 
NEW> 500 
NAM? TEST2 
NEW> 800 
NAM> EXIT 
symbol “TEST1" defined as 00000500 


sumbol “TEST2" defined as 00000800 
PATCH> 


The DEFINE command assigns the symbols TEST1 and TEST2 to 500 and 
800, respectively. The EXIT command is entered in response to 


the name prompt to terminate this level of prompting. 
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INSERT 


Description 


Use INSERT to insert VAX-11 MACRO instructions into specific 
locations within an image file. To use this command, you must 
specify the /INSTRUCTION qualifier or you must set the 
INSTRUCTION mode. To insert additional data into a patch area, 
use the DEPOSIT/PATCH_AREA command. 


Before inserting the new instruction, the INSERT command confirms 
the contents of the location preceding the insertion (that is, 
that current instruction). 


When the INSERT command is executed, it replaces the current 
instruction with a branch instruction and places the current 
instruction and the new instructions in the current patch area. 
The last new instruction is always followed by a _ branch 
instruction that redirects the flow of execution back to the 
inline code. The INSERT command automatically generates branch 
instructions. 


After the insertion of new instructions, the patch area _ string 
descriptor is updated to reflect the modifications. See Section 
5.3 for more information on patch area string descriptors. 


Calculating the Location for the Branch Instruction: When the 
INSERT command is executed, it replaces the current instruction 
with a branch instruction and places the current instruction and 
the new instructions in the patch area. Tf the branch 
instruction to the patch area is longer than the current 
instruction, additional instructions following the current 
instruction are also moved to the patch area, and the _ branch 
instruction is deposited in the vacated memory locations. Unused 
memory locations are filled with NOP instructions. 


On the other hand, if the current instruction is longer than’ the 
branch instruction, the unused memory locations are filled with 
NOP instructions. 


Calculating Relative Displacements for Branch Instructions: 
PATCH calculates the relative displacements for the branch 
instructions it generates and recalculates the relative 
displacements for all branch-type instructions moved to the patch 
area. Instructions and data moved to patch area may, however, be 
referenced by instructions not affected by the move. Note that 
PATCH does not recalculate any relative displacements in the 
unaffected instructions. 


Note also that if PATCH moves an instruction with a current 
address defined by a symbolic instruction label, you must check 
and correct any references made to that label. (See Section 
4.1.5 for a complete description on symbolic instruction labels.) 
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Format 


INSERT location = current-instruction 
new-instruction 


Mode Qualifiers Defaults 
/OCTAL 

/DECIMAL /HEXADECIMAL 
/HEXADECIMAL 

/({NO] INSTRUCTION /NOINSTRUCTION 
/ [NO] SYMBOLS /SYMBOLS 

/ [NO] GLOBALS /NOGLOBALS 

/ {NO] SCOPE /SCOPE 


Prompts 

LOC> location 

OLD> current-—-instruction 
NEW> new-instruction 
Parameters 


location 


Specifies the address after which one or more new instructions 
are to be added. 


current-instruction 


Specifies the instruction currently occupying the specified 
location. 


new-instruction 


Specifies one or more new instructions to be inserted into the 
image file following the current instruction. 


Mode Qualifiers 


/OCTAL 
/DECIMAL 
/HEXADECIMAL 


Determine the radix in which virtual addresses are interpreted 
and displayed. The radix mode qualifiers do not affect symbolic 
instructions. 


The initial default setting is /HEXADECIMAL. 


/ INSTRUCTION 
/NOINSTRUCTION 


Control whether the data to be inserted is interpreted as VAX-11 
MACRO instructions. To use the INSERT command, you must specify 
the /INSTRUCTION mode qualifier or you must set the INSTRUCTION 
mode. 


The initial default setting is /NOINSTRUCTION. 
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/ SYMBOLS 
/NOSYMBOLS 


Control whether locations are displayed as pathnames or’ symbols, 
rather than as numeric addresses. 


The initial default setting is /SYMBOLS. 


/GLOBALS 
/NOGLOBALS 


Control whether the symbolic entry (exactly as entered) is used 
as the first or last pathname in a search. 


The initial default setting is /NOGLOBALS. 


/SCOPE 
/NOSCOPE 


Control whether scope's contribution to a pathname to _ find 
locations. 


The initial default setting is /SCOPE. 
Examples 


1. PATCH> SET MODE INSTRUCTION 
PATCH> EXAMINE 600 


000006003 MOVL Ri»R4 
PATCH> EXAMINE 
000006023 BSBB LP.NAME 


PATCH> INSERT 602 = ’BSBE LP_NAME’ 
NEW> ‘CYTFW R3»#32° 
NEW> EXIT 


old? 6023 RSRB LP.NAME 
old’ 6043 CMPB R2*R8 
news 6023 BRW FAA 

new? 6053 NOP 

news 46063 NOP 

news PAA? BESBW LPONAME 
new$ 303743 CVTFW R32#32 
new? 303773 CMPB R2»R8 
news 307403 BRW 607 


This example shows the procedure used to insert an additional 
instruction into the existing code. After confirming the 
contents of location 602 and specifying the new instruction to be 
inserted, PATCH performs the following steps. 


a. Determines how many instructions from the existing code must 
be moved to patch area to make room for a branch instruction. 


b. Moves the instructions calculated in step 1 to the current 
patch area, and inserts in their places a branch instruction. 
PATCH calculates the relative displacement value for’ the 
branch instruction and generates a patch area symbol name to 
identify the destination of the branch. 


c. Fills the unoccupied locations in the existing code with NOP 
instructions. 


PATCH COMMANDS 


Recalculates the relative displacements for all 


branch-type 
instructions moved to patch area. 


Inserts into the patch area a= branch 
reroutes' the 


code. 


instruction that 
program's flow of execution back to the inline 


PATCH COMMANDS 


REPLACE 


Description 


Use REPLACE to replace the contents of one or more locations with 
new instructions or data in terms of the current mode settings. 
Before performing the replacement, the REPLACE command confirms 
the contents of the specified locations. 


Replacing Instructions: When you replace instructions and_ the 
new instructions occupy more bytes in memory than the current 
instructions, the new instructions are moved to patch area and 
PATCH generates branch instructions’ to maintain the program's 
logical flow of execution. PATCH generates branch instructions 
for the REPLACE command the same way that it does for the INSERT 
command. (See the INSERT command description for a description 
of the mechanics of generating branch instructions.) All unused 
bytes are filled with NOP instructions. 


If patch area is used to accommodate the new contents, the patch 
area string descriptor is updated to reflect the modifications. 
See Section 5.3 for more information on patch area. string 
descriptors. 


Replacing Data: When you replace ASCII or numeric data, _ the 
number of replacement entries cannot exceed the number of 
existing entries. This means, for example, that if you confirm 
the contents of six consecutive locations, you can replace the 
contents of only those six locations. If the number of 
replacement entries is less than the number of existing entries, 
the remaining locations are filled with zeros. 


In addition, PATCH truncates replacement entries if they exceed 
the limit imposed on them by the current length mode. For ASCII 
characters, the right-most characters are discarded. For numeric 
data, the left-most digits are discarded. 


Calculating Relative Displacements for Branch Instructions: 
PATCH calculates the relative displacements for the _ branch 
instructions it generates and recalculates the relative 
displacements for all branch-type instructions moved to the patch 
area. Instructions and data moved to the patch area may be 
referenced by instructions not affected by the move. Note that 
PATCH does not recalculate the relative displacement values in 
the unaffected instructions. 


Note also that if PATCH moves an instruction with a current 
address defined as a symbolic label, you must check and correct 
any references made to that label. See Section 4.1.5 for a 
complete description of symbolic instruction labels. Confirms 
that one or more consecutive locations contain the contents 
supplied; then replaces the contents with new contents. 
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Format 


REPLACE location = current-contents [,...] 
new-contents 


Mode Qualifiers Defaults 
/BYTE 

/WORD / LONG 

/ LONG 

/OCTAL 

/DECIMAL /HEXADECIMAL 
/HEXADECIMAL 

/(NO]ASCII /NOASCII 
/{NO] INSTRUCTION /NOINSTRUCTION 
/ {NO] SYMBOLS /SYMBOLS 

/ [NO] GLOBALS /NOGLOBALS 

/ [NO] SCOPE /SCOPE 


Prompts 

LOC> location 

OLD> current-contents 
NEW> new-contents 


Parameters 


location 


Specifies either (1) a single location whose contents are 


to be 


replaced or (2) the starting address of a sequence of locations 


whose contents are to be replaced. 


current-contents 


Specifies one or more data entries or instructions 


to be 


replaced. The data or instructions you specify must be the 


actual contents. 


Do not specify conflicting data types within a _ single 
command. 


new-contents 


Specifies one or more data entries or instructions’ that 
replace the current contents, 


Do not specify conflicting data types within a_ single 
command. 


REPLACE 


are to 


REPLACE 
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Mode Qualifiers 


/BYTE 
/WORD 
/ LONG 


Determine whether data is replaced in byte, word, or _ longword 
lengths. The length mode qualifiers affect only ASCII and 
numeric data. When you specify an instruction, the REPLACE 
command ignores the current length setting and replaces the 
entire instructions. 


The initial default setting is /LONG. 


/OCTAL 
/DECIMAL 
/HEXADECIMAL 


Determine the radix in which numeric data and addresses are 
interpreted and displayed. The radix mode qualifiers do not 
affect symbolic addresses, symbolic instructions, or ASCII data. 


The initial default setting is /HEXADECIMAL. 


/ASCII 
/NOASCII 


Control whether the data to be replaced and the data to be 
deposited are interpreted and displayed as ASCII data. 


When you specify /ASCII, enclose the data within matching 
quotation marks or apostrophes. The current radix setting has no 
affect on ASCII data being replaced or deposited; however, the 
REPLACE command truncates ASCII data if it exceeds the length 
imposed on it by the current length mode. 


The initial default setting is /NOASCII. 


/ INSTRUCTION 
/NOINSTRUCTION 


Control whether the data to be replaced and the data to be 
deposited are interpreted and displayed as VAX-11 MACRO 
instructions. 


When you specify /INSTRUCTION, enclose the instructions within 
matching quotation markS or apoStrophes. Neither the current 
radix setting nor the current length setting affect the 
instruction being replaced... 

The initial default setting is /NOINSTRUCTION. 


/SYMBOLS 
/NOSYMBOLS 


Control whether locations are displayed as pathnames or symbols, 
rather than as numeric addresses. 


The initial default setting is /SYMBOLS. 
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/GLOBALS 
/NOGLOBALS 
Control whether the symbolic entry (exactly as entered) is used 
as the first or last pathname in a search. The initial default 
setting is /NOGLOBALS. 
The initial default setting is /NOGLOBALS. 


/SCOPE 
/NOSCOPE 


Control whether scope's contribution to a pathname is used _ to 
find locations. 


The initial default setting is /SCOPE. 
Examples 
1. FATCH> SET MODE INSTRUCTION» NOSYMEOLS 


PATCH? REPLACE 600 = ’TSTL R4’ 
NEW: ‘°CMFB R22R4’ 


NEW: EXIT 

old? 000006003 TSTL R4 

olds 000006023 BEQL 00000610 
news 000006003 BRW 00007844 
news 00000604? NOF 

new $ 

news 0000784A3 CMPB R2,R4 
new 3 000078403 BNEQ 7852 
new? 0000784Fi BRW 00000610 


000078523 BRW 605 


The instruction occupying location 600 is replaced with the 
instruction CMPB R2,R4. This instruction occupies more bytes 
than the instruction TSTL R4. Thus, to make room for CMPB R2,R4, 
the instructions CMPB R2,R4 and the instruction that follows TSTL 
R4 are moved to the current patch area. A branch instruction is 
deposited in place of TSTL R4 to direct program execution to the 
patch area. The last instruction deposited in the patch area is 
a branch instruction back to the inline code. 


2. PATCH: SET SCOPE MODI 
PATCH? REPLACE/SCOPE RO_CODE+20 = 1000 


NEW: 100 
NEW: EXIT 
old? MODINE? 00001000 
news MODANE? 00000100 


The SET SCOPE command establishes the current symbolic scope as 
MOD1. A sSubSequent REPLACE command requests that the contents of 
location RO _CODE+20 in the module named MOD] be replaced with new 
data. The display indicates that the replacement was successful. 
Note that the location is reported by the pathname MOD1\E because 
the symbol E is the closest symbol to location RO_CODE+20. 
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SET ECO 


SET ECO 
Description 
Use SET ECO to define the ECO level for the ensuing patch. 


Whenever you apply a patch to an image file, the first command 
you type should be a SET ECO command. This command provides you 
with a way to identify your patches’ easily. More important, 
however, it lets you process selected patches using a command 
procedure. When PATCH processes a command procedure, it searches 
the file for ECO levels and processes only those patches 
represented by the specified ECO levels. Patches not represented 
by ECO levels are not processed. 


You can issue as many SET ECO commands as necessary during a 
PATCH session; however, once you specify an ECO level, that 
level can never be used again for that particular image file. 
Furthermore, whenever you begin a patch with a SET ECO command, 
you must also terminate the patch with the UPDATE command. If 
you fail to issue the UPDATE command (1) the ECO level specified 
with the SET ECO command is not set (hence, the patch is not 
applied to the image file), and (2) you cannot issue another SET 
ECO command. 


Format 

SET ECO eco-level 
Prompts 
ECO> eco-level 
Parameters 


eco-level 


Specifies a decimal integer between 1 and 128, inclusive. ECO 
levels outside this range of integers are illegal. 


Examples 


1. PATCH> SET ECO 15 
o 


PATCH> UPDATE 


XPATCH-I-WRIFIL» urdating image file DBA3’ CHOWARDINUFILE.EXE$2 
PATCH> CHECK NOT ECO 15 


APATCH-E-ECOSET» eco level 15 already set in DBAS: CHOQWARDINUFILE.EXE#2 


The SET ECO command defines the ECO level for the subsequent 
patch as 15. The commands are then entered. When the UPDATE 
command is issued, the ECO level is set and the image file is 
updated to include the affects of the new commands. The CHECK 
NOT ECO indicates that ECO level 15 is set in the image file 
NUFILE.EXE. 
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SET MODE 


Description 


Use SET MODE to control the syntax of the commands you enter and 
the values PATCH displays. 


Format 


SET MODE mode [,...] 


Prompts 


NEW> 


mode 


Parameters 


mode 


Specifies one or more modes from the context, radix, length, and 
symbol search mode categories to be established as the current 
modes. These modes determine how PATCH interprets entries and 
displays output. 


The commands that are affected by the entry and display modes 
are: DELETE, DEPOSIT, EVALUATE, EXAMINE, INSERT, REPLACE, and 
VERIFY. 


Table 8-1 summarizes the modes that can be set. See Chapter 6 
for a complete description of the rules for specifying entry and 
display modes. 


Table 8-1 
Mode Values for the SET MODE Command 


ASCII Control whether data is accepted 
NOASCII and displayed as ASCII characters 


Context INSTRUCTION Control whether data is accepted 


NOINSTRUCTION and displayed as  VAX-1l MACRO 
instructions. 


SYMBOLS Control whether addresses are 
NOSYMBOLS reported by pathnames or _ symbols 
rather than numeric addresses 


OCTAL Determine the base in which 
DECIMAL numeric addresses and data are 
HEXADECIMAL interpreted and displayed 





(continued on next page) 
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Table 8-1 (Cont.) 
Mode Values for the SET MODE Command 


Determine the length in which 
numeric data is accepted and 
displayed 





Mode 








Category 
BYTE 


WORD 
LONG 






Length 




























GLOBALS Control whether the symbolic entry 

Symbol NOGLOBALS (exactly as entered) is used as 

Search the first or last pathname in a 
search. 

SCOPE Control whether scope's’ contri- 






bution to a pathname is used _ to 
find locations. 


NOSCOPE 







Also note that you can alter a mode setting by specifying a mode 
qualifier with a command. 


Examples 
1. PATCH> SET MODE INSTRUCTIONsGLOBALS»sNOSYMBOLS 


This command requests that the modes INSTRUCTION, GLOBALS, and 
NOSYMBOLS be established as the current modes. 


2. PATCH> SET MODE INSTRUCTION 
PATCH> DEPOSIT 78B = ’BEQL NEWPATCH’ 


This SET MODE command establishes INSTRUCTION mode aS a current 
mode setting. A subsequent DEPOSIT command can then deposit an 
instruction without specifying the /INSTRUCTION mode qualifier. 


3. PATCH> SET MODE 
NEW? OCTAL 
NEW> WORD 
NEW? EXIT 


In this example, the SET MODE continuously prompts for new modes 
until EXIT is typed. 
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SET MODULE 


Description 


Use SET MODULE to enter local symbol information from _ the 
specified modules into PATCH'S symbol table, provided you 
followed the rules for passing local symbol information to PATCH 
(See Chapter 4). 


If the symbol table is too small to accommodate the local symbol 
information, PATCH displays an error message. 


Note that if you are patching a shareable image, no local or 
global symbol information is passed to PATCH; only universal 
symbols can be accessed. (See Chapter 4 for a complete 
description on using universal symbols at PATCH time and read the 
VAX-11 Linker Reference Manual for information on declaring 
symbols as universal at link time.) 





Format 


SET MODULE module-name [,...] 


Other Qualifiers Defaults 
/ALL None. 


Prompts 

NAM> module-name 
Parameters 
module~name 


Specifies the name of one or more modules whose local symbols are 
to be entered in the symbol table. 


Do not specify a module name if you include the /ALL qualifier. 


Other Qualifiers 


4 


/ALL 
Requests that local symbol information from all the modules’ in 
the image file be entered in the symbol table. 

Examples 


1. FPATCHS SET MODULE GREAT.APES 


PATCH} EXAMINE/ASCII ORANGUTANS 3 ORANGUTANS+8 
GREAT..APESNORANGUTANS$  ‘AMAZ‘’ 


GREAT.APES\ORANGUTANS+43 “ING 
THE SET MODULE command enters all local symbol information in the 
module GREAT APES into the symbol table. A subsequent EXAMINE 


command can use the local symbol ORANGUTANS~ to reference 
particular locations. 


2. FATCH® SET MODULE/ALL 


This command requests that all symbol information from all 
modules be added to the symbol table. 
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SET PATCH_AREA 


Description 


Use SET PATCH AREA to override the use of PATCH'sS default patch 
area in favor of the patch area you defined at assembly or 
compile time. (Section 5.2 describes the procedure for creating 
user-defined patch area.) 


Whenever you use a _ user-defined patch area, its patch area 
descriptor is updated to reflect any modifications. 


Format 
SET PATCH_AREA address-of-string-descriptor 
Prompts 
NEW> address-of-string-descriptor 
Parameters 
address-of-string-descriptor 


Defines the address of the patch area descriptor. The patch area 
descriptor can be represented as a symbolic or a numeric address. 
See Section 5.3 for a complete description of a patch area 
descriptor. 


Examples 


1. FATCH? SET FATCH AREA LROIFATCHES 
PATCH: SHOW FATCHUAREA 
current ratch area size} OQ000004F 
current ratch area address! QOOO0OSF2 


The SET PATCH AREA command establishes the user-defined patch 
area LRDPATCHES as the current patch area. The SHOW PATCH_AREA 
command reports the current status of LRDPATCHES. With this 


information, you can deposit instructions or data _ into 
LRDPATCHES. 
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SET SCOPE 


Description 


Use SET SCOPE to establish the specified module name (and routine 
name, if -.specified) as the explicit scope to be used under the 
rules for translating pathnames and symbols into values. These 
rules are discussed in Chapter 4. 

PATCH also inserts local symbol information associated with the 
specified module into the symbol table when you type the SET 
SCOPE. If the symbol table is too small to accommodate this 
information, PATCH issues an error message. 


Use the SHOW MODULE command to determine the modules to which the 
scope can be set. 


If the local symbols in a specific module have not been entered 
in the symbol table by the SET MODULE command, the SET SCOPE 
command forces those symbols into the table. 

Format 
SET SCOPE module-name [\routine-name [\...]] 

Prompts 

NEW> module-name [\routine-name] 

Parameters 

module—-name 
Specifies the name of the module to which the scope is to be set. 


routine-name 


Specifies the name of a routine contained in the module to which 
the scope is to be set. 


Examples 
1. FPATCH® SET SCOPE CARP_LPT 
This set command establishes the scope as CARP_LPT. 
2. FATCH> SET SCOPE 
NEW? LIF SIGN 
“FP ATCH-W-NOSUCHMODUs mo such module name "LIF.SIGN" 
In this example, there is no such module named LIP_SIGN. 


Therefore, the SET SCOPE command fails and the previous scope 
setting is retained. 
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SHOW MODE 


Description 


Use SHOW MODE to report the modes that are currently set. 


This command is used primarily with the SET MODE and/or CANCEL 
MODE commands. It indicates the condition of the current modes, 
enabling you to change one or more of them if necessary. 


When you issue the SHOW MODE command, the mode values are always 
displayed in lowercase letters. 


Format 


SHOW MODE 


Prompts 


Parameters 


Examples 


l. PATCH> SHOW MODE 
modes! symbols» noinstruction»y noasciisy scorer nosdlobals: hexadecimal longs 


The SHOW MODE command requests that the current modes be 
displayed. 
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SHOW MODULE 


Description 
Use SHOW MODULE to request PATCH to display all the modules in 
the image file and indicate whether the symbols contained in the 
modules are available for use. It also indicates the amount of 
symbol table space required by each module and routine and the 
total amount of unused space remaining in the symbol table. 


The SHOW MODULE command reports an informational error message if 
no local symbol information was passed to PATCH. 


Format 
SHOW MODULE 
Prompts 
None. 
Parameters 
None. 
Examples 


Ll. PATCH? SHOW MODULE 


module name symbols size 
AVERAGE no S2e 
OTS$LINKAGE ~ no 128. 
total modules? ae 

remaining size’ 64052. 


PATCH> SET MODULE/ALL 
PATCH> SHOW MODULE 


module name symbols size 
AVERAGE ves S26 
OTS$L INKAGE ves 128, 
total modules? Ze 

remaining size’ 63880. 


The first SHOW MODULE command indicates that there are _ two 
modules in the current image file, though neither one has its 
local symbols entered in the symbol table. The SET MODULE 
command requests that all local symbol information be entered in 
the symbol table. The second SHOW MODULE command confirms’ the 
presence of the local symbols in the symbol table. 


PATCH COMMANDS 


SHOW PATCH__AREA 


Description 


Use SHOW PATCH AREA to report the size and starting address of 
the current patch area in hexadecimal representation, regardless 
of the current radix setting. Generally, you use this command 
with either the ALIGN command or the DEPOSIT/PATCH AREA command. 
In both cases, you want to know the status of the patch area 
before realigning it or depositing data in it. 


Format 

SHOW PATCH AREA 
Prompts 
None. 
Parameters 
None. 
Example 

1. PATCH? SHOW PATCHUAREA 

current rPatch area size? 00000030 


current ratch area address: 00000308 
NEPOSIT/PATCH_AREA/ASCII 308= ’AT’ 


old: 000003082 
news 00000308: ‘AT’ 


The SHOW PATCH AREA display reports that the current patch area 
size is 30 bytes and the starting address is memory location 308. 
A subSequent DEPOSIT command can deposit data into the _ patch 
area. 


PATCH COMMANDS 


SHOW SCOPE 


Description 
Use SHOW SCOPE to display the current scope setting. 
Format 
SHOW SCOPE 
Prompts 
None. 
Parameters 
None. 
Examples 
1. PATCH> SHOW SCOPE 
score? TEMP1 
FATCH> EXAMINE LEGREES+8 
The SHOW SCOPE command indicates that the current scope setting 


is TEMPl. A subsequent EXAMINE command can reference a location 
using local symbol information contained in TEMP1. 


PATCH COMMANDS 


UPDATE 


Description 
Use UPDATE to apply a patch to the image file. 


The UPDATE command is a patch terminator. This command applies 
the previous patch to the image file and thus creates an output 
image file. If you fail to issue the UPDATE command, no output 
image file is created. 


During a single execution of PATCH, you can specify the UPDATE 
command more than once. The first UPDATE command specified 
creates a new output image file. Subsequent UPDATE commands 
(specified during that PATCH session) overwrite the output image 
file. That is, a new version of the output image file is not 
created. 


If a SET ECO command is issued, a subsequent UPDATE command 
automatically sets the ECO level specified. (See the description 
of the SET ECO command.) 

Format 
UPDATE 

Prompts 

None. 

Parameters 

None. 


Examples 


ls e 
e 
¢ 


PATCH? UPDATE 
ZPATCH-I-WRTFIL» urdating imase file DB1: CMASONIJHOROSCOFE.EXE 54 


The UPDATE command applies the previous patch to the image file 
HOROSCOPE.EXE. The UPDATE display indicates that the image file 
has been successfully updated. 


PATCH COMMANDS 


VERIFY 


Description 


Use VERIFY to confirm that a location or several consecutive 
locations contain the specified contents (instructions or data). 


Generally, you should use the VERIFY command with the DEPOSIT 
command. The DEPOSIT command does not confirm the entries before 
overwriting them. Therefore, to make certain you know the 
contents of the locations that will be modified, issue the VERIFY 
command first. 


The VERIFY command is also useful when you are patching an image 
file by means of a command procedure. Using the VERIFY command, 
you can check particular locations before attempting to modify 
them. If the VERIFY command fails, that patch is not applied, 
and PATCH skips to the next SET ECO command. If no other SET ECO 
command exists, the command procedure is terminated. 


Format 


VERIFY location = current-contents [,...] 


Mode Qualifiers Defaults 
/BYTE 

/WORD /LONG 

/ LONG 

/OCTAL 

/DECIMAL /HEXADECIMAL 
/HEXADECIMAL 

/{NO]ASCII /NOASCII 

/ (NO] INSTRUCTION /NOINSTRUCTION 
/(NO] SYMBOLS / SYMBOLS 

/ [NO] GLOBALS /NOGLOBALS 
/(NO] SCOPE /SCOPE 


Prompts 


LOC> location 
OLD> current-contents 


Parameters 
location 
Specifies either (1) a Single location whose contents are to be 


checked or (2) the starting address of a sequence of locations 
whose contents are to be checked. 


PATCH COMMANDS 


current-contents 


Specifies one or more data entries or instructions to be 
verified. The data or instructions you verify must be the actual 
contents. 


Do not specify conflicting data types within a single VERIFY 
command. 


Mode Qualifiers 


/BYTE 
/WORD 
/ LONG 


Determine whether data is verified in byte, word, or longword 
lengths. The length mode qualifiers affect only ASCII and 
numeric data. When you specify an instruction, the VERIFY 
command ignores’ the current length mode and verifies the entire 
instruction. 


The initial default setting is /LONG. 


/OCTAL 
/DECIMAL 
/HEXADECIMAL 


Determine the radix in which numeric data and addresses are 
interpreted and displayed. The radix mode qualifiers do not 
affect symbolic addresses, symbolic instructions, and ASCII data. 


The initial default setting is /HEXADECIMAL. 


/ASCII 
/NOASCII 


Control whether the data to be verified is interpreted and 
displayed as ASCII data. 


When you specify /ASCII, enclose the data within matching 
quotation marks or apostrophes. The current radix setting has no 
affect on the ASCII data being verified; however, the VERIFY 
command truncates the data if it exceeds the limit imposed on it 
by the current length mode. 


The initial default setting is /NOASCII. 


/ INSTRUCTION 
/NOINSTRUCTION 


Control whether the data to be verified is interpreted and 
displayed as VAX-11 MACRO instructions. 


When you specify /INSTRUCTION, enclose the instructions within 
matching quotation marks or apostrophes. Neither the current 
radix setting nor the current length setting affect the 
instruction being verified. 


The initial default setting is /NOINSTRUCTION. 


PATCH COMMANDS 
/SYMBOLS 
/NOSYMBOLS 


Control whether locations are displayed as pathnames or symbols, 
rather than as numeric addresses. 


The initial default setting is /SYMBOLS. 


/GLOBALS 
/NOGLOBALS 


Control whether the symbolic entry (exactly as entered) is used 
as the first or last pathname in a search. 


The initial default setting is /NOGLOBALS. 


/SCOPE 
/NOSCOPE 


Control whether scope's contribution to a pathname is used _ to 
find the specified location. 


The initial default setting is /SCOPE. 


Examples 


1. FATCH? VERIFY/ASCII/NOSYMBOLS 6FF = ‘RAIN’ 
olds QOOQOOGFF ¢ “RAIN? 


The VERIFY command confirms that the ASCII text RAIN resides in 
location 6FF. The /NOSYMBOLS mode qualifier requests’ that 
location 6FF be displayed as a virtual address in terms of the 
current radix. 


APPENDIX A 


COMMAND SUMMARY 


This appendix lists in alphabetical order each PATCH command in its 
required format, the qualifiers you can specify with the command, and 
a brief description of the command's function. The bold face letters 
indicate the characters you must type for PATCH to recognize the 
command name or qualifier. 


Format Function 
ALIGN /alignment-qual symbol Aligns the current patch area on the 
/BYTE, /WORD, /LONG, given boundary and assigns a symbol to 
/QUAD, /PAGE that address. 
CANCEL MODE Cancels the current modes and reinstates 
the initial default modes. 
CANCEL MODULE module-name [....] Removes local symbols defined in one or 
/ALL more given modules from PATCH’s sym- 
bol table. 
CANCEL PATCH_AREA Cancels the use of the current patch area 


and reverts to the use of the default patch 
area. 


CANCEL SCOPE Cancels the current symbolic scope and 
reverts to the null scope. 

CHECK ECO eco-level [:...] [,...] Verifies the application of the patches as- 
sociated with the given ECO levels. 

CHECK NOT ECO eco-level [:...] [,...] Verifies that the given ECO levels are 


available for use. 


CREATE [file-spec] Creates a command procedure. All subse- 
quent, successful commands are written 
into this file. 


DEFINE symbol = value [,symbol = value,...] Assigns a symbol to a value. Multiple as- 
signments can be made. 
DELETE /mode-qual loc = current-contents [,...] Verifies the current contents of one or 
/BYTE, /WORD, /LONG, /OCTAL, more consecutive locations, then replaces 
/DECIMAL, /HEXADECIMAL, /[NOJASCIHI, the contents with NOPs or zeros. 


/[NOJINSTRUCTION, /[NOJGLOBALS, 
/[NOJSCOPE, /[NO]JSYMBOLS 


DEPOSIT /mode-qual /add-qual loc = new-contents {,...] 1. Deposits new contents into one or 
/BYTE, /WORD, /LONG, /OCTAL, more consecutive locations. 
/DECIMAL, /HEXADECIMAL, /[NOJASCII, : . 
/[NOJINSTRUCTION, /[NO]GLOBALS, 2. Deposits new contents into one or 
/[NO]SCOPE, /[NO]JSYMBOLS, /PATCH__AREA more consecutive locations in the cur- 


rent patch area. Use the /PATCH— 
AREA qualifier. 


EVALUATE /mode-qual expression [,...] Displays the current definition of one or 
/BYTE, /WORD, /LONG, /OCTAL, more expressions. 
/DECIMAL, /HEXADECIMAL, /[NOJASCII, 
/[NOJINSTRUCTION, /[NOJGLOBALS, 
/[NO]SCOPE, /[NO]JSYMBOLS 


A-l 


COMMAND SUMMARY 


Format 


EXAMINE /mode-qual loc [:loc] [,...] 
/BYTE, /WORD, /LONG, /OCTAL, 
/DECIMAL, /HEXADECIMAL, /[NOJASCII, 
/[NO]JINSTRUCTION, /[NO]JGLOBALS, 
/[NO]JSCOPE, /[NO]SYMBOLS 


EXIT 


INSERT /mode-qual loc = current-instruction 
new-instruct 


/OCTAL, 

/DECIMAL, /HEXADECIMAL, 
/INSTRUCTION, /[NO] GLOBALS, 
/[NOJSCOPE, /[NO]SYMBOLS 


REPLACE /mode-qual loc = current-contents [,...] 
new-contents 


/BYTE, /WORD, /LONG, /OCTAL, 
/DECIMAL, /HEXADECIMAL, /[NO]ASCII, 
/[NO] INSTRUCTION, /[NO]GLOBALS, 
/[NOJSCOPE, /[NO]SYMBOLS 


SET ECO  eco-level 
SET MODE mode-parameter [,...] 


SET MODULE module-name [,...] 
/ALL 


SET PATCH__AREA address-of-string-descriptor 
SET SCOPE module-name \routine-name [\...] 


SHOW MODE 
SHOW MODULE 


SHOW PATCH__AREA 


SHOW SCOPE 
UPDATE 
VERIFY /mode-qual loc = current-contents [,...] 


/BYTE, /WORD, /LONG, /OCTAL, 
/DECIMAL, /HEXADECIMAL, /[NOJASCII, 
/[NOJINSTRUCTION, /[NOJGLOBALS, 
/[NO]JSCOPE, /[NO]JSYMBOLS 


Function 


Displays the contents of one or more loca- 
tions. 


1. Terminates a command sequence 
prompt. 


2. Terminates a PATCH session. 


Verifies the current contents of a loca- 
tion, then inserts one:or more symbolic 
instructions after that location. 


Verifies the contents of one or more con- 
secutive locations, then replaces the con- 
tents with new contents. 


Defines an ECO level for the ensuing 
patch. The ECO level is not set until an 
UPDATE command is issued. 


Sets one or more new entry and display 
modes. 


Enters local symbol information defined 
in one or more given modules into 
PATCH’s symbol table. 


Establishes a user-defined patch area as 
the current patch area. 


Defines the current symbolic scope. 


Displays the current mode settings. 


Displays all modules in the image that is 
being patched and displays whether the 
local symbols contained in those modules 
are available for use. 


Displays the string descriptor of the cur- 
rent patch area. 


Displays the current symbolic scope. 


Sets the ECO level and applies the patch 
to the image file. 


Verifies the contents of one or more con- 
secutive locations. 


APPENDIX B 


ERROR MESSAGES 


When you issue an incorrect PATCH command, PATCH’ responds by 
displaying a descriptive error message. All error messages are 
reported to SYSSERROR and SYSSOUTPUT. . Error messages are also 
recorded in the journal file corresponding to the image file being 
patched. This lets you examine all the commands you used to patch 
your image file. 


Error messages are divided into four categories: informational 
messages, warning messages, severe error messages, and fatal error 
messages. These categories are distinguished by their level of 
severity. When processing command procedures, PATCH terminates 
execution and aborts the procedure if it encounters an error. other 
than an informational message. During an interactive session, PATCH 
is aborted only upon encountering a fatal error. 


The format for reporting error messages is as follows: 
%FACILITY-L-TTTTT, message 
%FACILITY 


The facility issuing the error message. In most cases’ the 
facility will be PATCH. 


L 
The severity level of the error. The Severity levels are: 
I -- Informational message 
W -- Warning message 
E -- Severe error message 
F -- Fatal error message 
TTTTT: 
A mnemonic description of the error. 
message 


The error message displayed in response to the erroneous’ PATCH 
command. | 


The remainder of this chapter lists and describes the error messages 
issued by PATCH. The error messages are listed alphabetically, 
regardless of the severity level. This is because the severity level 
for a particular error message may differ depending upon the context 
in which it was issued. 


B-l1 


ERROR MESSAGES 


BADECO, illegal eco level of nn in file-spec 
Indicates that you specified an ECO level outside the range of 
legal ECO levels. Legal ECO levels fall between 1 and 128, 
inclusive. 


BADIDENT, unable to patch image with ident of nn 


Indicates that PATCH does not understand this version of the 
image file. Relink your image file. 


BADOPCODE, opcode xx is unrecognized 
Indicates that you specified an instruction that PATCH does not 
recognize. Note that PATCH does not accept abbreviations for 
instructions. For example, ADDL cannot be substituted for ADDL2. 


BADSCP, scope setting not module or routine 


Indicates that the symbol you specified as the new scope value is 
not a module name or routine name. 


BRTOOFAR, destination addr is too far for branch operand 
Indicates that the relative displacement for the branch-type 
instruction is not large enough to reach the specified 
destination address. 


CLIERR, cli error parsing command line 


Indicates that you incorrectly entered the command line that 
invokes PATCH; reenter the command line correctly. 


CLSERR, close error code of xx on file file-spec 


Indicates that the SCLOSE request failed due to the error code 
represented aS xx. : 


CNTERR, connect error code of xx on file file-spec 


Indicates that a VAX-11 RMS SCONNECT request failed due to the 
error code represented aS xx. 


CRMPSC, error code of xx mapping section 


Indicates that the system service SCRMPSC request failed due _ to 
the error represented as xx. 


DELTVA, error code of xx deleting xxx to xxx 


Indicates that the system service SDELTVA request failed due _ to 
the error code represented as xx. 


DIFVAL, memory contains different value than specified 


Indicates that the value you specified is not contained within 
the given memory location. 


DIVZERO, attempt to divide by zero 


Indicates that you attempted to divide by zero. 


ERROR MESSAGES 


DUPCOMFIL, command file file-spec already being written 


Indicates that you have already requested that a command 
procedure be written for this PATCH session. 


ECONOTSET, eco level nn not set in file-spec 
Indicates that you specified an ECO level that has not yet been 
set in that particular image file. This typically occurs when 
you issue the CHECK ECO command before issuing the UPDATE 
command. 


ECOSET, eco level nn already set in file-spec 


Indicates that you specified an ECO level that has already been 
set in that particular image file. 


ENDPRS, error code of xx on command line parse end 


Indicates that a command interpreter callback request failed due 
to the error code represented as xx. 


EXARANGE, invalid range of addresses 


Indicates that you specified a range of addresses using an 
incorrect format. The correct format is: 


lower-boundary-address: upper-boundary-address 
EXPREG, error code of xx expanding program region 


Indicates that the system service SEXPREG request failed due to 
the error code represented aS xx. 


EXPSTKOVR, expression too nested, stack overflow 


Indicates that you attempted to evaluate an expression that 
contains more than 16 levels of nested arguments. 


EXTBIT, illegal extract bit number - greater than 31 


Indicates that you specified an illegal bit number; legal bit 
numbers range from 0 through 31, inclusive. 


FRERANGE, Storage package range error 


Indicates an internal PATCH error; please submit a Software 
Performance Report. 


FRESIZE, storage package size error 


Indicates an internal PATCH error; please submit a Software 
Performance Report. 


GBLONLY, cannot obtain global copy of image section image-section 


Indicates that the image being patched references a global copy 
of an image section. There is no local copy of this section 
within the image file. To patch such a section, you must patch 
the shareable image file in which it is contained. 
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GBLWARN, patching local copy of global image section image-section 
Indicates that the image being patched references a global image 
section. The image contained a local copy of the global image 
section and only the local copy is being patched. 

GETERR, read error code of xx on file file-spec 


Indicates that a VAX-1l1 RMS SGET read request failed due to the 
error code represented as xx. 


GETTIM, error code of xx on SGETTIM 


Indicates that the system service SGETTIM request failed due to 
the error code represented as xx. 


HDRBLK, too many isd's for image header blocks 


Indicates that you requested too many image section descriptors; 
PATCH is unable to create patch area. Relink your image file. 


INITPRS, error code of xx on command line parse init 


Indicates a CLI callback failure due to the error code 
represented as xx; please submit a Software Performance Report. 


INSOPRND, missing instruction operand 


Indicates that you omitted one or more operands from. the 
instruction. 


INSUFPAT, nn bytes requested, patch area at addr contains nn bytes 
Indicates that the user-defined patch area is not large enough to 
accommodate the specified code. To remedy the situation, uSe an 
alternate patch area, for example, the default patch area. 
Generally, the default patch area is expandable. 

INVCMD, invalid command 


Indicates that you issued a command and either omitted or 
incorrectly entered required punctuation. 


INVDSTREC, invalid DST record 
Indicates an error in the debugger's symbol table of that 
particular image file; please submit a Software Performance 
Report. 

INVIMGHDR, inconsistent debug and symbol data in image header 
Indicates that the image header inconsistently describes’ the 
symbol information causing the absence of symbol information at 
PATCH time. Please submit a Software Performance Report. 

INVNUMBER, invalid numeric string 


Indicates that you specified a numeric data string that is 
illegal in the current context. 


INVOPR, unrecognized operator in expression 


Indicates that the expression contained a character that PATCH 
did not recognize, in place of a valid operator. 


ERROR MESSAGES 


INVOPRND, unable to resolve operand xx 


Indicates that you specified an operand that PATCH does not 
recognize. Operands such as 4(r0) must be preceded by B”, for 
example, B*4(ROQ). 


INVQUO, quoted argument not allowed in current mode 


Indicates that you attempted to enter an argument enclosed in 
quotation marks or apostrophes and you were not in INSTRUCTION or 
ASCII mode. 


INVTOKEN, unrecognized token symbol-name 


Indicates that the symbol you specified is not recognized as a 
valid PATCH command name or qualifier. 


JNLPUT, error writing to journal file 


Indicates that an output error occurred while PATCH was’ writing 
to the journal file. 


LONGDST, unable to include all module names in symbol table 


Indicates that when you initialized PATCH, the image file could 
not accommodate all the modules it found. To determine which 
modules were placed in the symbol table, issue the SHOW MODULE 
command. To make room for the new modules, issue the CANCEL 
MODULE command specifying the module names whose symbols are no 
longer required. Then reissue the SET MODULE command. 


MEMBUG, dynmem error size=nn addr=nn error=nn 


Indicates an internal PATCH error; Please submit a Software 
Performance Report. 


MISSQUO, unmatched quotation marks in argument 


Indicates that you did not use matching quotation marks or 
apostrophes to enclose an argument. PATCH inserts the necessary 
quote for you and continues command execution. 


MODIFYERR, modify error code of xx on file file-spec 


Indicates that a VAX-11 RMS SMODIFY request failed due to the 
error code represented as xx. 


MODNOTADD, insufficient symbol table space to add module module-name 


Indicates that the SET MODULE command failed. This typically 
occurs when there is not enough space in the symbol table to 
accommodate the additional module or modules. To make room _ for 
the new modules, issue the SHOW MODULE command to determine which 
modules are in the symbol, then CANCEL MODULE command specifying 
the module names whose symbols’ are no longer required. Then 
reissue the SET MODULE command. 


MULTECO, multiple eco levels (nn and nn) set for one patch 
Indicates that you attempted to define a second ECO level before 


setting the first ECO level. To set the first ECO level, issue 
the UPDATE command. 


ERROR MESSAGES 


MULTOPR, multiple successive operators in expression 


Indicates that you entered an expression containing more than one 
operator in succession. 


NOACCESS, cannot access image section 


Indicates that you specified an address contained in an image 
section that is not within this image file. 


NOANGLE, unmatched angle brackets in expression 


Indicates that you entered an expression that has an_ unequal 
number of right angle brackets to left angle brackets. 


NOBRANCH, instruction requires branch-type operand 
Indicates that you attempted to enter a branch-type instruction 
with an invalid operand for a destination field. For example, 
PATCH does not accept: DEPOSIT/INSTRUCTION GO= 'BNEQ RO’. 


NOCONTIG, non-contiguous image file being written 


Indicates that the output file is a noncontiguous image file. To 
ensure a contiguous output file, after you exit from PATCH use: 


$ COPY/CONTIGUOUS input-file-spec output-file-spec 
NODECODE, cannot decode instruction 


Indicates that PATCH encounterd an undefined opcode or illegal 
addressing mode while attempting to decode the instruction. 


NOENCODE, cannot encode instruction instr 


Indicates that the instruction contained an illegal opcode or 
operand. The branch destination may not be reachable from the 
location for which it was destined. 


NOFREE, no free storage available 


Indicates an internal PATCH error; please submit a Software 
Performance Report. 


NOGBL, some or all global symbols not accessible 


Indicates that when you initialized PATCH, no global _ symbol 
information was available to PATCH. To ensure that global symbol 
information is passed to PATCH, reassemble or recompile your 
program including the debug or traceback facility. 


Or, the symbol table was not large enough to incorporate all the 
global symbol information. 


NOLCL, image does not contain local symbols 


Indicates that when you initialized PATCH, no local symbol 
information was available to PATCH. To ensure that local symbol 
information is passed to PATCH, reassemble or recompile your 
program including the debug or traceback facility. 
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NOLITERAL, no LITERAL translation exists for xx 


Indicates that the value represented as xx does not have a 
symbolic equivalent associated with it. 


NOOPRND, missing operand in expression 


Indicates that you omitted one or more operands from the 
expression. 


NOPATAREA, insufficient patch area at addr, size = nn 


Indicates that the current user-defined patch area was not large 
enough to store the given code. Use the default patch area or an 
alternate user-defined patch area of a larger size. 


NORELOC, relocation of CASE instructions not supported 


Indicates that PATCH does not automatically move CASE 
instructions to the patch area. You move CASE instructions to 
the patch area by use of the DELETE/INSTRUCTION and 
DEPOSIT/INSTRUCTION/PATCH AREA commands and the MACRO assembler 
directive .WORD. ~ 


NORSTBLD, cannot build symbol table 


Indicates that when you initialized PATCH, it could not allocate 
Space to build a symbol table. 


NOSUCHMODU, no such module name module-name 


Indicates that you specified the name of a module not contained 
in the image file. 


NOSUCHSYM, no such symbol 


Indicates that you specified a symbol not contained in PATCH's 
symbol table. 


NOSYMBOL, no such symbol symbol-name 


Indicates that you specified a symbol not contained in PATCH's 
symbol table. 


NOTALLSYM, unable to initialize symbols for default modules 


Indicates that the symbol table did not have enough room _ to 
include symbols for all the modules normally inserted into the 
table upon execution of PATCH. 


NOTDONE, xx not yet a Supported feature 


Indicates that the feature you attempted to use is recognized but 
not implemented by PATCH. The name of the feature is indicated 
in the error message. 


NOTPATAREA, patch area is addrl not addr2 


Indicates that you typed the incorrect starting address of the 
patch area. To determine the correct starting address, issue the 
SHOW PATCH AREA command or the ALIGN/BYTE command. When you 
issue ALIGN/BYTE, PATCH defines a name as the current starting 
address. 
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NOTQUO, unquoted argument not allowed in ASCII or INSTRUCTION modes 
Indicates that, while in ASCII or INSTRUCTION mode, you entered 
an argument not enclosed within matching apostrophes or quotation 
marks. 

NOUPDATE, no patch for update qualifier eco level nn 
Indicates that when you submitted a command procedure for 
interactive or batch execution (by typing 
PATCH/UPDATE = (eco-level, ...)), and you specified an ECO level 
that was not included in the command procedure. 

NSADDR, address addr is not within image 


Indicates that you specified an address outside the address range 
of the image file. 


NUMOPRNDS, xx instructions must have nn operands 
Indicates that you omitted an operand from the MACRO-11 
instruction. Reissue the PATCH command with the correct number 
of operands. 


NUMTRUNC, number truncated 


Indicates that PATCH truncated a numeric data entry because it 
exceeded the current length mode. 


NUMVAL, error code of xx requesting update value 


Indicates that a command interpreter callback request failed due 
to the error code represented as xx. 


OLDINSCHK, memory location addr not equal to xx 
Indicates that the verification of the contents of the given 
address failed. Reissue the PATCH command specifying the correct 
value. 

OLDVALCHK, memory location addr not equal to xx 
Indicates that the verification of the contents of the given 
address failed. Reissue the PATCH command specifying the correct 
value. 


OPNERR, open error code of xx on file file-spec 


Indicates that a VAX-11 RMS SOPEN request failed due to the error 
code represented aS xx. 


OPRNDLNG, operand xx too long for internal buffers 


Indicates an internal PATCH error; please submit a Software 
Performance Report. 


OPSYNTAX, instruction operand syntax error 


Indicates that there is a syntactical error in an operand within 
an instruction. 


OUTCMDLNG, output command line too long for buffer 


Indicates an internal PATCH error; please submit a Software 
Performance Report. : 
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PARSEERR, internal parsing error 


Indicates an internal PATCH error; please submit a Software 
Performance Report. 


PATERR, internal patch coding error 


Indicates an internal PATCH error; please submit a Software 
Performance Report. 


PATHLONG, too many qualifiers on name 


Indicates that you entered a pathname consisting of more than 15 
elements. 


PRIMIN, error code of xx parsing input file 


Indicates that a command interpreter callback request failed due 
to the error code represented aS xx. 


PRIMOUT, error code of xx parsing journal file 


Indicates that a command interpreter callback request failed due 
to the error code represented as xx. 


PUTERR, put error code of xx on file file-spec 


Indicates that an error writing the specified file occurred due 
to the error code represented as xx. 


REDEFSYM, redefining symbol symbol-name from addrl to addr2 
Indicates that a user-defined symbol has been changed to a 
different value. This typically occurs when you issue the DEFINE 
command and specify a symbol currently used in the image file or 
when PATCH moves a VAX-11 MACRO instruction that contains a label 
to a patch area. 

REPLACEERR, replacement value too large for location 


Indicates that when you replaced data with the REPLACE command, 
the new data was comprised of more bytes than the old data. 


RESOPCODE, opcode xx is reserved 


Indicates that you specified an opcode that is reserved for 
DIGITAL use only. 


SECOUT, error code of xx parsing journal file 


Indicates that a command interpreter callback request failed due 
to the error code represented as xx. 


STGTRUNC, string truncated 
Indicates that PATCH truncated an ASCII string entry because it 
either exceeded the current length mode or was inappropriate for 
the context in which it was specified. 


SYNTAX, command syntax error at or near xx 


Indicates that you incorrectly entered the part of the command 
line represented as xx. 


ERROR MESSAGES 


TEROUT, error code of xx parsing command file 


Indicates that a command interpreter callback request failed due 
to the error code represented as xx. 


UPDATE, patch with eco level nn ignored due to update qualifier 
Indicates that PATCH ignored the patch associated with this ECO 
level because you used the /UPDATE qualifier and did not include 
this particular ECO level in the qualifier's value list. 


WRTFIL, updating image file file-spec 


Indicates that the specified image file has been updated _ to 
include the previous patch. 
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Abbreviating Commands, 
See Truncating 
Abbreviating commands in command 
procedures, 
created using CREATE command, 
2-5 
created using text editor, 2-5 
Accessing user-defined patch area, 
5-3 . 
Addition operator, 7-5 
Address values, 
translating into symbols, 4-7, 
6-5 
Addressing locations, operators 
for, 
backslash operator, 7-9, 8-25 
current location operator, 7-8 
previous location operator, 7-8 
range operator, 7-9 
table of, 7-8 
Addressing modes, 
See Entry and display modes 
ALIGN command, 1-11, 5-3, 5-5, 
8-2, 8-18, 8-46 
alignment qualifiers, 8-3 
description, 8-2 
examples, 8-3 
format, 8-2 
parameters, 8-2 
prompts, 8-2 
Alignment qualifiers, 1-10 
/BYTE, 8-3 
/LONG, 8-3 
/PAGE, 8-3 
/QUAD, 8-3 
/WORD, 8-3 
/ALL other qualifier, 8-5, 8-41 
Arithmetic expressions, evaluat- 
ing, 8-22 
Arithmetic expressions, operators 
for, 
addition operator, 7-5 
arithmetic shift operator, 7-6 
division operator, 7-6 
multiplication operator, 7-6 
priority operator, 7-7 
radix operator, 7-7 
subtraction operator, 7-5 
table of, 7-5 
Arithmetic shift operator, 7-6 
ASCII data strings, rules for en- 
tering, 7-2 
ASCII-NOASCII modes, 1-7, 6-4, 
7-2, 8-13, 8-16, 8-19, 8-23, 
8-26, 8-36, 8-39, 8-50 


/ASCII-/NOASCII mode qualifiers, 
8-13, 8-16, 8-19, 8-23, 8-26, 
8-36, 8-50 


Backslash operator, 7-9, 8-25 
Bit fields, variable-length, 
evaluating, 8-22 
Branch instructions, 
calculating the location for, 
8-30 
calculating relative displace- 
ments for, 8-30, 8-34 
/BYTE alignment qualifier, 8-3 
BYTE mode, 1-7, 6-5, 8-16, 8-19, 
8-23, 8-31, 8-36, 8-40, 8-50 
/BYTE mode qualifier, 8-16, 8-19, 
8-23, 8-26, 8-36, 8-50 


C 


Calculating relative displace- 
ments for branch instructions, 
8-30, 8-34 

Calculating the locations for 
branch instructions, 8-30 

CANCEL MODE command, 1-6, 1-12, 
6-3, 8-4, 8-44 

description, 8-4 
examples, 8-4 
format, 8-4 
parameters, 8-4 
prompts, 8-4 

CANCEL MODULE command, 

8-5 
description, 8-5 
examples, 8-5 
format, 8-5 
other qualifiers, 8-5 
parameters, 8-5 
prompts, 8-5 

CANCEL PATCH_AREA command, 1-11, 

5-3, 8-7 
description, 8-7 
examples, 8-7 
format, 8-7 
parameters, 8-7 
prompts, 8-7 

CANCEL SCOPE command, 

description, 8-8 
examples, 8-8 
format, 8-8 
parameters, 8-8 
prompts, 8-8 


1-5, 1-13, 


t=13, 8=5 
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Changing default file specifica- 
tions, 
journal file, 2-2, 3-3 
output image file, 2-3, 3-3 
CHECK ECO command, 1-1ll, 8-9, 
8-10 
description, 8-9 
examples, 8-9 
format, 8-9 
parameters, 
prompts, 8-9 
CHECK NOT ECO command, 
description, 8-10 
examples, 8-10 
format, 8-10 
parameters, 8-10 
prompts, 8-10 
Command procedures, 
abbreviating commands in, 2-5 
created using CREATE command, 
2-3, 8-11 
created using text editor, 
function of, 2-3 
processing selected patches in, 
3-2 
submitting for batch execution, 
1-1, 1-2, 2-1, 2-3, 3-3, 
submitting for interactive exe- 
cution, 1-1, 1-2, 2-1, 2-3, 
3-2 
using symbolic references in, 
2-4, 2-5 
Command procedures, creating, 
using CREATE command, 2-3, 8-11 
using text editor, 2-5 
Command prompting, rules for, 
Command qualifiers, 
default values for /JOURNAL and 
/OUTPUT, 3-4 
format of, 3-3 
/JOURNAL command qualifier, 3-3 
/OUTPUT command qualifier, 2-2, 
3-3 
table of, 3-3 
/UPDATE command qualifier, 3-2, 
3-3 
Command summary, A-1 
Commands, PATCH, 
See PATCH Commands 
Commands for controlling PATCH 
modes, 1-12 
Commands for creating patches, 
1-11 
Commands for examining and modify- 
ing locations, 1-12 
Commands for expressing symbols 
and pathnames, 1-13 
Commands for manipulating patch 
area, 1-11 
Comments, rules for entering, 7-3 


8-9 


1-11, 8-10 


2-5 


7-1 


Constructing command procedures, 
See Command procedures 
Context modes, 1-6, 6-1 
ASCII-NOASCII, 1-7, 6-4, 7-2, 
8-13, 8-16, 8-19, 8-23, 
8-26, 8-36, 8-39, 8-50 
INSTRUCTION-NOINSTRUCTION, 1-7, 
6-3, 7-3, 8-13, 8-16, 8-20, 
8-23, 8-26, 8-31, 8-36, 
8-39, 8-50 
SYMBOLS-NOSYMBOLS, 1-7, 4-8, 
6-4, 8-16, 8-20, 8-26, 8-32, 
8-36, 8-39, 8-51 
Specifying, 1-6, 6-3 
Continuing commands over multiple 


lines, rules for, 7-2 
CREATE command, 1-2, 1-11, 2-3, 
8-11 


description, 8-11 
examples, 8-12 
format, 8-1ll 
parameters, 8-1ll 
prompts, 8-ll 
Creating command procedures 
See Command procedures 
Creating user-defined patch area, 
5-2 
CTRL/Y, 1-3, 3-7 
CTRL/Z, 1-3, 3-7, 8-29 


Current location operator, 7-8 
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DECIMAL mode, 1-7, 6-5, 8-16, 
8-19, 8-23, 8-26, 8-31, 8-36, 
8-40, 8-50 

/DECIMAL mode qualifier, 8-16, 
8-19, 8-23, 8-26, 8-36, 8-50 

Default file specification, 

journal file, 2-3 
output image file, 2-2 
overriding, 3-3 

Default patch area, 1-6, 

DEFINE command, 1-13, 2-5, 
7-3, 8-13, 8-29 

description, 8-13 
examples, 8-14 

format, 8-13 

parameters, 8-13 
prompts, 8-13 

DELETE command, 

8-39 
description, 8-15 
examples, 8-17 
format, 8-15 
parameters, 8-15 
prompts, 8-15 

Delimiting parameter values, 
for, 7-3 
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1-12, 7-3, 8-15, 


rule 
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DEPOSIT command, 1-6, 1-11, 1-12, 
5-5, 7-3, 7-4, 8-18, 8-39, 
8-46, 8-49 


description, 8-18 
examples, 8-20 
format, 8-18 z 
mode qualifiers, 8-19 
other qualifiers, 8-20 
parameters, 8-19 
prompts, 8-19 
Depositing data or instructions, 
8-18 
Depositing data or instructions 
into patch area, 8-18 
Device-driver image file, 1-1, 2-2 
using user-defined patch area, 
2-2, 5-1 
Display modes, 
See Entry and display modes 
Division operator, 7-6 


E 


ECO level, 8-9, 8-10, 
function, 1-4 
how to define an, 1-4, 1-9 
how to set an, 1-4, 1-9 
Entering ASCII data strings, 
rules for, 7-2 
Entering comments, rules for, 
Entering numeric data, 
7-3 
Entering VAX-11 MACRO instruc- 
tions, rules for, 7-2 
Entry and display modes, 1 
ASCII-NOASCII modes, 1-7, 6-4, 
7-2, 8-13, 8-16, 8-19, 8-23, 
8-26, 8-36, 8-39, 8-50 
BYTE mode, 1-7, 6-5, 8-16, 
8-19, 8-23, 8-26, 8-36, 
8-40, 8-50 
context modes, 
DECIMAL mode, 1-7, 6-5, 8-16, 
8-19, 8-23, 8-26, 8-31, 
8-36, 8-39, 8-50 
function, 1-6, 6-1 
functional division of, 1-7 
GLOBALS-NOGLOBALS modes, 1-7, 
4-7, 6-6, 8-17, 8-20, 8-23, 
8-26, 8-37, 8-40, 8-51 
HEXADECIMAL mode, 1-7, 6-5, 
8-16, 8-19, 8-23, 8-26, 
8-31, 8-36, 8-39, 8-50 
initial default settings, 
8-4 
INSTRUCTION-NOINSTRUCTION modes, 
1-7, 6-3, 7-3, 8-13, 8-16, 
8-20, 8-23, 8-26, 8-31, 
8-36, 8-39, 8-50 
length modes, 1-6, 6-5 


8-38, 8-48 


7-3 
rules for, 


=1 


1-6, 6-3 


1-6 ’ 


Entry and display modes, (Cont.) 
LONG mode, 1-7, 6-5, 8-16, 
8-19, 8-23, 8-26, 8-36, 
8-40, 8-50 
modes and mode qualifiers, 6-3 
OCTAL mode, 1-7, 6-5, 8-16, 
8-19, 8-23, 8-26, 8-31, 
8-36, 8-39, 8-50 
radix modes, 1-6, 6-5 
reinstating initial default 
settings, 8-4 
SCOPE-NOSCOPE modes, 1-7, 
6-6, 8-17, 8-20, 8-24, 
8-32, 8-37, 8-40, 8-51 
specifying, 1-6, 1-9, 6-3 
through 6-6 
symbol search, 1-6, 6-6 
SYMBOLS-NOSYMBOLS modes, 1-7, 
4-8, 6-4, 8-16, 8-20,8-26, 
8-32, 8-36, 8-39, 8-51 
table of, 6-1 
temporary settings, 6-3 
WORD mode, 1-7, 6-5, 8-16, 
8-19, 8-23, 8-32, 8-36, 
8-40, 8-50 
Error messages, 
EVALUATE command, 
8-39 
description, 8-22 
examples, 8-24 
format, 8-22 
mode qualifiers, 8-23 
parameters, 8-23 
prompts, 8-23 
Evaluating arithmetic expres- 
sions, 8-22 
Evaluating values, 8-22 
Evaluating variable-length bit 
fields, 8-22 
EXAMINE command, 
8-39 
description, 8-25 
examples, 8-27 
format, 8-25 
mode qualifiers, 8-26 
parameters, 8-25 
prompts, 8-25 
Executable image file, 1-1, 2-2 
EXIT command, 1-3, 1-9, 3-7, 8-29 
description, 8-29 
examples, 8-29 
format, 8-29 
parameters, 8-29 
prompts, 8-29 
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File specification, 
command procedure, 3-2, 3-3 
input image file, 3-1 


4-7, 
8-27, 


B-1l 
1-13, 8-22, 


1-12, 7-4, 8-25, 
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INDEX 


File specification, (Cont. ) 
journal file, 2-3 
output image file, 2-2 
File specification, overriding, 
journal file, 2-3, 3-3 
output image file, 2-2, 3-3 
Format of error messages, B-l 
Functional division of entry and 
display modes, 1-7 
Functional division of PATCH com- 
mands, 1-10 


G 


Global symbols, 1-5, 4-1 

GLOBALS-~NOGLOBALS modes, 1-7, 
4-7, 6-6, 8-17, 8-20, 8-23, 
8-26, 8-37, 8-40, 8-51 

/GLOBALS-/NOGLOBALS mode quali- 
fiers, 8-17, 8-20, 8-23, 
8-26, 8-32, 8-37, 8-51 


H 


HEXADECIMAL mode, 1-7, 6-5, 8-16, 
8-19, 8-23, 8-26, 8-31, 8-36, 
8-39, 8-50 

/HEXADECIMAL mode qualifier, 
8-16, 8-19, 8-23, 8-26, 8-31, 
8-36, 8-50 


Image file, 
dGevice-driver, 1-1, 2-2 
executable, 1-1, 2-2 
input, 1-2, 2-1 
output, 1-2, 2-2 
Shareable, 1-1, 2-1 
Input and output files, PATCH, 
1-2, 2-1 
Input file, 1-1 
input image file, 1-2, 2-1 
Input image file, 1-2, 2-1 
INSERT command, 1-11, 1-12, 5-4, 
7-3, 7-4, 8-18, 8-30, 8-34, 
8-39 . 
description, 8-30 
examples, 8-32 
format, 8-31 
mode qualifiers, 8-31 
parameters, 8-31 
prompts, 8-31 
INSTRUCTION-NOINSTRUCTION mode, 
1-7, 6-3, 7-3, 8-13, 8-26, 
8-31, 8-36, 8-39, 8-50 
/INSTRUCTION-/NOINSTRUCTION mode 
qualifiers, 7-4, 8-13, 8-16, 
8-20, 8-23, 8-26, 8-31, 8-36, 
8-50 


Invoking PATCH, 1-3, 1-9, 3-1 
for interactive execution 3-1 
for processing command proce- 

dures interactively, 3-2 
for submitting command proce- 
dures for batch execution, 


3-3 
J 


Journal file, 1-1, 1-2, 2-1, 2-2 
default file specification, 2-3 
example of, 2-4 
overriding default file speci- 

fication, 3-3 
/7JOURNAL command qualifier, 2-3, 


3-3 
Keywords, truncating, 7-4 


Length modes, 1-6, 6-1 
BYTE, 1-7, 6-5, 8-16, 8-19, 
8-23, 8-26, 8-36, 8-40, 
8-50 
LONG, 1-7, 6-5, 8-16, 8-19, 
8-23, 8-26, 8-36, 8-40, 
8-50 
Specifying, 1-6, 6-5 
WORD, 1-7, 6-5, 8-16, 8-19, 
8-23, 8-32, 8-36, 8-40, 
8-50 
Local labels, 4-1 
Local symbols, 1-5, 4-2 
/LONG alignment qualifier, 8-3 
LONG mode, 1-7, 6-5, 8-16, 8-19, 
8-23, 8-26, 8-36, 8-40, 8-50 
/LONG mode qualifier, 8-16, 8-19, 
8-23, 8-26, 8-36, 8-50 


Mode qualifiers, 1-6, 1-10, 6-3, 


8-40 

/ASCII-/NOASCII mode qualifiers, 
8-13, 8-16, 8-19, 8-23, 
8-26, 8-36, 8-50 

/DECIMAL mode qualifier, 8-16, 
8-19, 8-23, 8-26, 8-31, 
8-36, 8-50 

/BYTE mode qualifier, 8-16, 
8-19, 8-23, 8-26, 8-36, 
8-50 

/GLOBALS-/NOGLOBALS mode qual- 
ifiers, 8-17, 8-20, 8-26, 
8-32, 8-37, 8-51 

/HEXADECIMAL mode qualifier, 
8-16, 8-19, 8-23, 8-26, 
8-31, 8-36, 8-50 
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Mode qualifiers, (Cont. ) 
/ INSTRUCTION~/NOINSTRUCTION 
mode qualifiers, 7-4, 8-13, 
8-16, 8-20, 8-23, 8-26, 
8-31, 8-36, 8-50 
/LONG mode qualifier, 8-16, 
8-19, 8-23, 8-26, 8-36, 
8-50 
/OCTAL mode qualifier, 8-16, 
8-19, 8-23, 8-26, 8-31, 
8-36, 8-50 
/SCOPE-/NOSCOPE mode qualifiers, 
8-17, 8-20, 8-24, 8-27, 
8-32, 8-37, 8-51 
/SYMBOLS-/NOSYMBOLS mode qual- 
ifiers, 8-16, 8-20, 8-26, 
8-32, 8-36, 8-51 
Versus entry and display modes, 
6-3 
/WORD mode qualifier, 8-16, 
8-19, 8-23, 8-26, 8-36, 
8-50 
Modes, 
See Entry and display modes 
Module names, 1-5, 4-2 
Multiplication operator, 7-6 
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NOASCII-ASCII modes, 1-7, 6-4, 
7-2, 8-13, 8-16, 8-23, 8-26, 
8-36, 8-39, 8-50 

/NOASCII-/ASCII mode qualifiers, 
8-13, 8-16, 8-19, 8-23, 8-26, 
8-36, 8-50 

NOGLOBALS-GLOBALS modes, 1-7, 
4-7, 6-6, 8-17, 8-20, 8-23, 
8-26, 8-37, 8-40, 8-51 

/NOGLOBALS-/GLOBALS mode quali- 
fiers, 8-17, 8-20, 8-23, 
8-26, 8-32, 8-37, 8-51 

NOINSTRUCTION-INSTRUCTION modes, 
1-7, 6-3, 7-3, 8-13, 8-16, 
8-20, 8-23, 8-26, 8-31, 8-36, 
8-39, 8-50 

/NOINSTRUCTION-INSTRUCTION mode 
qualifiers, 7-4, 8-13, 8-16, 
8-20, 8-23, 8-31, 8-36, 8-50 

NOSCOPE-SCOPE modes, 1-7, 4-7, 
6-6, 8-17, 8-20, 8-24, 8-27, 
8-32, 8-37, 8-40, 8-51 

/NOSCOPE-/SCOPE mode qualifiers, 
8-17, 8-20, 8-24, 8-27, 8-32, 
8-37, 8-51 

NOSYMBOLS-SYMBOLS modes, 1-7, 4-8, 
6-4, 8-16, 8-20, 8-26, 8-32, 
8-36, 8-39, 8-51 

/NOSYMBOLS-/SYMBOLS mode quali- 
fiers, 8-16, 8-20, 8-26, 
8-32, 8-36, 8-51 

Numeric data, rule for entering, 
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OCTAL mode, 1-7, 6-5, 8-16, 8-19, 
8-23, 8-26, 8-31, 8-36, 8-39, 
8-50 

/OCTAL mode qualifier, 8-16, 
8-19, 8-23, 8-26, 8-31, 8-36, 
8-50 

Offset value, 1-5, 4-7 

Operators, 

addition, 7-5 
arithmetic shift, 7-6 
backslash, 7-9, 8-25 
current location, 7-8 
division, 7-6 
multiplication, 7-6 
previous location, 7-8 
priority, 7-7 
range, 7-9 
Subtraction, 7-5 
table of, 7-5, 7-8 
Other qualifiers, 1-10 
/ALL, 8-5, 8-41 
Output files, 
command procedure, 1-2, 2-3 
journal file, 1-2, 2-3 
output image file, 1-2, 2-2 
Output image file, 1-2, 2-2 
default file specification, 2-2 
overriding default file speci- 
fication, 3-3 

Overriding default file specifi- 
cations, 3-3 

/OUTPUT command qualifier, 2-2, 
3-2 
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PAA through PZZ, 5-3 
/PAGE alignment qualifier, 8-3 
Parameter values, rules for de- 
limiting, 7-3 
Patch area, 1-1 
commands affecting, 5-3 
default, 1-6, 5-l 
string descriptor, 5-3 
symbols, 4-1, 5-3 
used with device-driver images, 
2-2, 5-1 
used with shareable images, 
2-2, 5-1 
user-defined, 1-6, 5-1 
Patch area string descriptor, 5-3 
Patch area symbols, 4-1, 5-3 
PATCH command, 1-3 
formats, 3-1 
optional command qualifiers, 
3-3 
PATCH commands, 
ALIGN, 1-11, 5-3, 
8-18, 8-46 


D5; 8-2, 
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PATCH commands, (Cont. ) 


CANCEL MODE, 1-6, 1-12, 6-3, 
8-4, 8-44 

CANCEL MODULE, 1-5, 1-13, 8-5 

CANCEL PATCH AREA, 1-11, 5-3, 
8-7 

CANCEL SCOPE, 1-13, 8-8 

CHECK ECO, 1-11, 8-9, 8-10 

CHECK NOT ECO, 1-11, 8-10 

command summary, A-1 

CREATE, 1-11, 2-3, 8-11 

DEFINE, 1-13, 2-5, 4-6, 7-3, 


PATCH utility, (Cont.) 


command summary, A-1 

entry and display modes, 1-6, 
1-9, 6-1 

error messages, B-l 

functional division of com- 
mands, 1-10 

how to apply a patch, 1-4 

input and output files, 1-2, 
2-1 

interrupting, 1-3, 3-7 

invoking, 1-3, 3-1 


8-13, 8-29 
DELETE, 1-12, 7-3, 8-15, 8-39 
detailed descriptions of all, 
8-1 through 8-51 


overview, 1-1 
patch area, 1-6, 5-1 
pathnames, 1-5 
sample session using, 1-7 
DEPOSIT, 1-6, 1-1ll, 1-12, 5-5, symbol table, 1-4, 1-5, 4-6, 
7-3, 7-4, 8-18, 8-39, 8-46, symbolic referencing, 1-4, 1-5, 
8-49 1-9, 4-1 
EVALUATE, 1-13, 8-22, 8-39 symbols, 4-1 
EXAMINE, 1-12, 7-4, 8-25, 8-39 terminating, 1-3, 3-7 
EXIT, 1-3, 1-9, 3-7, 8-29 versus the VAX-11 Symbolic De- 
for controlling PATCH modes, bugger, 1-2 
La i2 when to use, 1-1 
for creating patches, 1-11 Patching an image file, 
for examining and modifying example, 1-7 
locations, 1-12 Previous location operator, 7-8 
for expressing symbols and Priority operator, 7-7 
pathnames, 1-13 Processing command procedures in- 
for manipulating patch area, teractively, 3-2 
1-11 Processing selected patches, 
functional summary of, 1-10 in command procedures, 3-5 
INSERT, 1-11, 1-12, 5-4, 7-3, interactively, 3-5 
7-4, 8-18, 8-30, 8-34, 8-39 Program section names, 1-5, 4-2 
REPLACE, 1-9, 1-12, 5-4, 7-3, 
8-18, 8-34, 8-39 
SET ECO, 1-4, 1-9, 8-9, 8-38, Q 


SET se eo 130. }s12.-6=93 /QUAD alignment qualifier, 8-3 
8-39. B-AA ‘ : ’ Qualifiers, 
v 5 - 
SET MODULE, 1-5, 1-9, 1-13, alignment, 1-10 
4-2, 8-41, 8-43 Sere 
SET PATCH AREA, 1-11, 5-3, 8-7, mode, 1-6, 1-10 
8-42 ~ other, 1-10 
SET SCOPE, 1-5, 1-9, 1-11, truncating, 7-4 
SHOW MODE, 1-12, 6-3, 8-44 R 
SHOW MODULE, 1-5, 1-13, 4-6, 
8-43, 8-45 Radix modes, 1-6, 6-1 
SHOW PATCH AREA, l-1l, 5-3, DECIMAL, 1-7, 6-5, 8-16, 8-19, 
8-18, 8-46 8-23, 8-26, 8-31, 8-36, 


SHOW SCOPE, 1-13, 8-47 
syntax rules, 7-1 through 7-10 
UPDATE, 1-4, 1-9, 1=-1ll, 2-2, 
3-7, 8-9, 8-38, 8-48 8-36, 8-39, 8-50 
VERIFY, 1-12, 7-3, 8-39, 8-49 OCTAL, 1-7, 6-5, 8-16, 8-19, 
Patch initiator, 1-4, 8-38 8-23, 8-26, 8-31, 8-36, 
Patch terminator, 1-4, 8-48 8-39, 8-50 
Pathnames, 1-5, 4-7 specifying, 1-6, 6-5 
PATCH utility, 1-1 Radix operator, 6-5 
command descriptions, 8-1 Range operator, 7-9 


8-39, 8-50 
HEXADECIMAL, l-7, 6-5, 8-16, 
8-19, 8-23, 8-26, 8-31, 
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REPLACE command, 1-9, 1-12, 5-4, 
7-3, 8-18, 8-34, 8-39 
description, 8-34 
examples, 8-37 
format, 8-35 
mode qualifiers, 8-36 
parameters, 8-35 
prompts, 8-35 
Replacing data, 8-34 
Replacing instructions, 8-34 
Routine names, 1-5, 4-2 
Running PATCH, 
See Invoking PATCH 


Ss 


Sample PATCH session, 1-7 
Scope, 1-5, 4-7 
/SCOPE-/NOSCOPE mode qualifiers, 
8-17, 8-20, 8-24, 8-27, 8-32, 
8-37, 8-51 
SCOPE-NOSCOPE modes, 1-7, 4-7, 
6-6, 8-17, 8-20, 8-24, 8-27, 
8-32, 8-37, 8-40, 8-51 
SET ECO command, 1-4, 1-9, 8-9, 
8-38, 8-48, 8-49 
description, 8-38 
examples, 8-38 
format, 8-38 
parameters, 8-38 
prompts, 8-38 
SET MODE command, 1-6, 1-9, 1-12, 
6-3, 8-39, 8-44 
description, 8-39 
examples, 8-40 
format, 8-39 
parameters, 8-39 
prompts, 8-39 
SET MODULE command, 1-5, 1-9, 
1-13, 4-2, 8-41, 8-43 
description, 8-41 
examples, 8-41 
format, 8-41 
other qualifiers, 8-41 
parameters, 8-41 
prompts, 8-41 
SET PATCH AREA command, 1-11, 
5-3, 8-7, 8-42 
description, 8-42 
examples, 8-42 
format, 8-42 
parameters, 8-42 
prompts, 8-42 
SET SCOPE command, 1-5, 1-9, 
1-11, 1-13, 4-7, 8-43 
description, 8-43 
examples, 8-43 
format, 8-43 
parameters, 8-43 
prompts, 8-43 


Shareable image file, 1-1, 2-1 
use of patch area, 2-2, 5-1 
use of symbols, 2-2, 4-2 

SHOW MODE command, 1-12, 6-3, 

8-44 

description, 8-44 

examples, 8-44 

format, 8-44 

parameters, 8-44 

prompts, 8-44 

SHOW MODULE command, 1-5, 1-13, 

4-6, 8-43, 8-45 

description, 8-45 

examples, 8-45 

format, 8-45 

parameters, 8-45 

prompts, 8-45 

SHOW PATCH AREA, 1-11, 5-3, 8-18, 

8-46 

description, 8-46 

examples, 8-46 

format, 8-46 

parameters, 8-46 

prompts, 8-46 

SHOW SCOPE command, 1-13, 8-47 
description, 8-47 
examples, 8-47 
format, 8-47 
parameters, 8-47 
prompts, 8-47 

Specifying entry and display 

modes, 6-3 
context, 1-6, 6-3 
length, 1-6, 6-5 
radix, 1-6, 6-5 
symbol search, 1-6, 6-6 

Stopping PATCH, 

See terminating PATCH 

Storage space, 

See patch area 
String descriptor, patch area, 
5-3 
SUBMIT command, 3-3 
Submitting command procedures for 
patch execution, 3-3 
Submitting command procedures for 
interactive execution, 
See processing command proce- 
dures interactively 

Subtraction operator, 7-5 

Summary of PATCH commands, A-1l 

Symbol search modes, 1-6, 6-1 
GLOBALS-NOGLOBALS, 1-7, 4-7, 

6-6, 8-17, 8-20, 8-23, 
8-26, 8-37, 8-40, 8-51 
SCOPE-NOSCOPE, 1-7, 4-7, 6-6, 
8-17, 8-20, 8-24, 8-27, 
8-32, 8-37, 8-40, 8-51 
specifying, 1-6, 6-6 
Symbol table, 1-5, 4-6 
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Symbolic instruction labels, 1-5, 
8-30 
function, 4-4 
side effect, 4-4 
Symbolic referencing, 1-1, 1-4 
Symbolic references, in command 
procedures, 
created using CREATE command, 
2-4 
created using interactive text 
editor, 2-5 
Symbol-name, 4-7 


Symbols, 
defined with DEFINE command, 
1-5, 4-6 


global, 1-5, 4-1 
local, 1-5, 4-1 
module names, 1-5, 4-2 
passing, 1-6 
patch area, 5-3 
program section names, 1-5, 4-2 
routine names, 1-5, 4-2 
symbolic instruction labels, 
1-5, 4-4, 8-30 
translating into address 
values, 4-7, 6-6 
universal, 1-5, 4-2 
Symbols defined with DEFINE com- 
mand, 1-5, 4-6 
/SYMBOLS-/NOSYMBOLS mode quali- 
fiers, 8-16, 8-20, 8-26, 
8-32, 8-36, 8-51 
SYMBOLS-NOSYMBOLS modes, 1-7, 
4-8, 6-4, 8-16, 8-20, 8-26, 
8-32, 8-36, 8-39, 8-51 
Syntax rules, 
command prompting, 7-1 
continuing commands over multi- 
ple lines, 7-2 
delimiting parameter values, 
7-3 
entering ASCII data strings, 
7-2 
entering comments, 7-3 
entering numeric data, 7-3 
entering VAX-11 MACRO instruc- 
tions, 7-2 
operators for addressing 
locations, 7-7 
operators for arithmetic 
expressions, 7-4 
truncating keywords, 7-4 
VAX-11 MACRO instructions 
with same opcodes, 7-9 


T 


Terminating PATCH, 1-3, 1-9, 3-7, 
8-29 

Terminating use of user-defined 
patch area, 5-3 


Translating, 
address values into symbols, 
4-8, 6-5 
symbols into address values, 
4-7, 6-6 


Truncating, 
commands, 7-4 
parameter values, 7-4 
qualifiers, 7-4 
Truncating commands, in command 
procedures, 

See Abbreviating commands, in 
command procedures 
Truncating keywords, rules for, 

7-4 


U 


Universal symbols, 1-5, 4-2 
declaring, 4-2 ; 
used with shareable images, 
2-2, 4-2 
UNIVERSAL= option, 4-2 
UPDATE command, 1-4, 1-9, 1-11, 
2-2, 3-7, 8-9, 8-38, 8-48 
description, 8-48 
examples, 8-48 
format, 8-48 
parameters, 8-48 
prompts, 8-48 
Updated input image file, 
See output image file 
User-defined patch area, 1-6, 5-1 
accessing, 5-3 
creating, 5-3 
terminating, 5-3: 
when to use, 5-2 
Using PATCH, 
interactively, 1-1, 1-2 
on DIGITAL software, 1-1 
with command procedures, 
batch execution, 1-1, 1-2 
interactive execution, 1-l, 
1-2, 
/UPDATE command qualifier, 3-3 


V 


Values, evaluating, 8-22 
Variable-length bit fields, eval- 
uating, 8-22 
VAX-11 Image File Patch Utility, 
1-1 
VAX-11 MACRO instructions, rules 
for entering, 7-2 
VAX-11 MACRO instructions, with 
Same opcodes, 
rules for use, 7-9 
table of, 7-10 
VAX-11 Symbolic Debugger, 1-2, 
1-8 
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VERIFY command, 1-12, 7-3, 8-39, W 
8-49 

description, 8-49 
examples, 8-51 /WORD alignment qualifier, 8-3 
format, 8-49 WORD mode, 1-7, 6-5, 8-16, 8-19, 
mode qualifiers, 8-50 8-23, 8-36, 8-40, 8-50 
parameters, 8-49 /WORD mode qualifier, 8-16, 8-19, 
prompts, 8-49 8-23, 8-26, 8-36, 8-50 
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VAX-11 PATCH Utility Reference Manual 
AA-H785A-TE 
READER'S COMMENTS 


This form is for document comments only. DIGITAL will 
use comments submitted on this form at the company's 


_ discretion. If you require a written reply and are 


eligible to receive one under Software Performance 
Report (SPR) service, submit your comments on an SPR 
form. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Did you find errors in this manual? If so, specify the error and the 
page number. 


Please indicate the type of reader that you most nearly represent. 


a 


Name 


Assembly language programmer 
Higher-level language programmer 
Occasional programmer (experienced) 
User with little programming experience 
Student programmer 

Other (please specify) 


Date 


Organization 


Street 


City. 


State... Zip Code 
or 
Country 
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